# Sample Application ## Installation ### - Download Download [**WinFaceSDKDemo.rar \[145M\]**](https://drive.google.com/file/d/1X31r6vHNYGVkhQNO2ph-bJmvCurTkNJX/view?usp=drive_link) 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.