# 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.