# Sample Application ## Installation ### - Download Download [**WinFaceSDKDemo.rar \[145M\]**](https://www.dropbox.com/scl/fi/jxqqbtgz77d1ehj11pynv/WinFaceSDKDemo.rar?rlkey=7abi2u51e8kg3bvgrt37rj9u8\&st=undfe1s7\&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
video_surveillance_demo\	1:N Video Surveillance demo code

### - Install dependencies Install `python-3.8.9.exe`, `VC_redist.2013.exe`, `VC_redist.2015-2022.exe` files from `dependency` directory. {% hint style="warning" %} When install `python-3.8.9.exe`, have to tick the `Add Python3.8 to PATH` option.

{% endhint %} ### - Setting Up SDK License Key Copy the `license.txt` license file to the `engine` directory.

*** ## Test ### - Test Flask Server APIs * Install sub-dependencies for Flask Demo {% code overflow="wrap" %} ```sh cd flask python -m pip install -r requirements.txt ``` {% endcode %} * Run `app.py` script: {% code overflow="wrap" %} ```shell python app.py ``` {% endcode %}

* To test the Flask Server API, you can use [Postman](https://www.postman.com/downloads/). Here are the endpoints for testing: #### POST /api/analyze\_face Perform face analysis on an image file **Parameters** **image:** image file **Response** **result:** face detection result **face\_rect:** face bounding box of detected face **attribute:** attributes(age, gender, liveness, mask, wear\_glass) of detected face #### POST /api/compare\_face Perform face match between two face image files **Parameters** **image1:** image file for the 1st face **image2:** image file for the 2nd face **Response** **result:** face match result **similarity:** similarity between two faces **detection:** face bounding boxes of two faces

Postman usage guide for Flask Demo (analyze_face)

Postman usage guide for Flask Demo (compare_face)

### - Test Gradio * Install sub-dependencies for Gradio Demo {% code overflow="wrap" %} ```sh cd gradio python -m pip install -r requirements.txt ``` {% endcode %} * Run `app.py` script: {% code overflow="wrap" %} ```shell python app.py ``` {% endcode %}

* Go to on a web browser.

### - Test 1:N Surveillance * Install sub-dependencies for Surveillance Demo {% code overflow="wrap" %} ```sh cd video_surveillance_demo python -m pip install -r requirements.txt ``` {% endcode %} * Run `app.py` script: {% code overflow="wrap" %} ```shell python app.py ``` {% endcode %}

* Main Page When you run the `app.py` script, the main page appears first.

* Register Person Page You can enroll user from image.

* User List Page The registered user list is displayed.

* Photo Match Page You can identify registered users from selected image.

* Video Surveillance Page You can identify registered users from video stream. Media file, RTSP stream, Web Camera can be used as video stream.

--- # 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-recognition-sdk/integration-guide/windows/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.