# Sample Application ## Docker Pull the Docker image and run the container: {% code overflow="wrap" %} ```sh sudo docker pull recognito/id-ocr:latest sudo docker run -it -e LICENSE_KEY="XXXXX-XXXXX-XXXXX-XXXXX" -p 8001:8000 -p 7861:7860 recognito/id-ocr:latest [OPTION --gradio(-g), --flask(-f)] ``` {% endcode %} ## Installation ### - Download Download [**ID\_SDK.zip**](https://www.dropbox.com/scl/fi/2cfmyjmzhncsqjqy5tdv4/ID_SDK.zip?rlkey=o3wn5hin2hud0idx47benc2xv\&st=p5shq37x\&dl=0) The Demo directory contains the following directories and files:


dependency\	Dependency files
engine\	SDK engine files
examples\	Sample images
flask\	Flask server side demo code
gradio\	Gradio demo code
Dockerfile	Dockerfile for building a Docker image
install.sh	Script for install environment
license.txt	License key file
run_demo.sh	Script for run demo

### - Install dependencies Run the `install.sh` script to install dependencies: ```sh ./install.sh ``` ### - Setting Up SDK License Key * **Online Licensing:** Set the online license key as an environment variable: {% code overflow="wrap" %} ```sh export LICENSE_KEY="XXXXX-XXXXX-XXXXX-XXXXX" ``` {% endcode %} * **Offline Licensing:** Copy the `license.txt` license file to the demo directory. *** ## Test ### - Run Demo Run the demo script with the desired option: {% code overflow="wrap" %} ```sh ./run_demo.sh [OPTION --gradio(-g), --flask(-f), --help(-h)] ``` {% endcode %}

### - Test Flask Server APIs To test the Flask Server API, you can use [Postman](https://www.postman.com/downloads/). Here are the endpoints for testing: #### POST /api/read\_idcard Extract data from ID card. **Parameters** **image:** image file for the front of ID card **image2:** image file for the back of ID card **Response** **data:** OCR result #### POST /api/read\_idcard\_base64 Extract data from ID card base64 images. **Parameters** **image1:** base64 image for the front image **image2:** base64 image for the back image **Response** **data:** OCR result

### - Test Gradio Go to on a web browser.

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.recognito.vision/id-document-recognition-sdk/integration-guide/linux/sample-application.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.