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


dependency\	Dependency files
engine\	SDK engine files
examples\	Sample images for face liveness detection
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: ``` ./install.sh ``` ### - Setting Up SDK License Key * **Online Licensing:** Set the online license key as an environment variable: {% code overflow="wrap" %} ```sh export FL_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/check\_liveness Perform face liveness detection and attribute analysis on an image file **Parameters** **image:** image file **Response** **result:** face liveness, attribute check result **liveness\_score:** liveness score of detected face **face\_rect:** face bounding box of detected face **angles:** Pitch, Yaw, Roll of detected face #### POST /api/check\_liveness\_base64 Perform face liveness detection and attribute analysis on a base64 image **Parameters** **image:** base64 image **Response** **result:** face liveness, attribute check result **liveness\_score:** liveness score of detected face **face\_rect:** face bounding box of detected face **angles:** Pitch, Yaw, Roll of detected face

### - 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/face-liveness-detection-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.