# FaceLivenessDetection - Windows

view

This is the `Face Liveness Detection` `Python` project for `Windows` Server.

It stands for `3D passive face liveness detection` python, `face anti-spoofing` python, `face fraudulent check` python, `face liveness check` python, `fraud prevention` python, `spoof prevention` python, `face fraud detection` python and `biometric fraud` with liveness detection on `Windows` server.

## SDK

{% content-ref url="../../product/face-liveness-detection-sdk-face-recognition-sdk/face-liveness-detection-sdk-server" %}
[face-liveness-detection-sdk-server](https://docs.kby-ai.com/help/product/face-liveness-detection-sdk-face-recognition-sdk/face-liveness-detection-sdk-server)
{% endcontent-ref %}

## Github

{% embed url="<https://github.com/kby-ai/FaceLivenessDetection-Windows>" %}

## Test Online

{% embed url="<https://web.kby-ai.com/>" %}

<figure><img src="https://2589216230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WwtQK0VFwKRGmIjGA3I%2Fuploads%2FroDOxwFnJk20NBmWxhUJ%2Fimage.png?alt=media&#x26;token=620cd700-b70b-4aee-93b8-9b772b891a48" alt=""><figcaption></figcaption></figure>

## Postman

To test the API, you can use `Postman`. Here are the `endpoints` for testing:

* Test with an image file: Send a `POST` request to <http://18.221.33.238:8080/check_liveness>
* Test with a `base64-encoded` image: Send a `POST` request to <http://18.221.33.238:8080/check_liveness_base64>
* You can download the `Postman` collection to easily access and use these `endpoints`. [click here](https://github.com/kby-ai/FaceLivenessDetection-Docker/blob/main/postman/kby-ai-live.postman_collection.json)

<figure><img src="https://2589216230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WwtQK0VFwKRGmIjGA3I%2Fuploads%2FS1OVRkxjpppjsRMtAUA8%2Fimage.png?alt=media&#x26;token=3dea51fb-61b3-45d5-b23e-eeb2b9fa927c" alt=""><figcaption></figcaption></figure>

## How to Run

> We have not published facesdk1.dll. If you need the SDK DLL, please get in touch with us.

### 1. System Requirements

**CPU:** 2 cores or more (Recommended: 8 cores)&#x20;

**RAM:** 4 GB or more (Recommended: 8 GB)&#x20;

**HDD:** 4 GB or more (Recommended: 8 GB)&#x20;

**OS:** Windows 7 or later&#x20;

**Dependency:** `OpenVINO`™ Runtime (Version: 2022.3), ncnn Runtime(20220721), `Vulkan SDK` Runtime(1.3.250)

### 2. Install SDK from DockerHub

`SDK` could be installed easily from `DockerHub` repository pushed by `KBY-AI` team as discribed in the follwing [link](https://hub.docker.com/r/kbyai/face-liveness-detection).

* Pull docker image from the repository.

```bash
sudo docker pull kbyai/face-liveness-detection:latest
```

* Get machine code with the following command.

```bash
sudo docker run -e LICENSE="xxxxx" kbyai/face-liveness-detection:latest 
```

To request the license, please provide us with the machine code obtained from your console.

<figure><img src="https://2589216230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WwtQK0VFwKRGmIjGA3I%2Fuploads%2FxcXsbkAJJQBoG41WzT71%2FScreenshot%202025-03-10%20225017.png?alt=media&#x26;token=f73bfe85-8959-4c43-8aaa-d7b31ce23dbe" alt=""><figcaption><p>How to get machine code</p></figcaption></figure>

* Run `docker` container with license key file from `KBY-AI` team.

```bash
sudo docker run -v ./license.txt:/root/kby-ai-live/license.txt -p 8080:8080 -p 9000:9000 kbyai/face-liveness-detection:latest
```

### 3. Install SDK from GitHub

* Clone the project:

```bash
git clone https://github.com/kby-ai/FaceLivenessDetection-Windows.git
```

* Download the model from `Google Drive` and unzip it: [click here](https://drive.google.com/file/d/1bYl0p5uHXuTQoETdbRwYLpd3huOqA3wY/view?usp=share_link)
* Run the `Python` code:

```bash
python test.py
```

* Send us the `machine code` and replace the `license.txt` file you received. Then, run the `Python` code again.

<figure><img src="https://2589216230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WwtQK0VFwKRGmIjGA3I%2Fuploads%2FwZXuZTD6HnzoMvJV7Yja%2Fimage.png?alt=media&#x26;token=8b9b5b94-310a-4d89-8357-8144565673f6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2589216230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WwtQK0VFwKRGmIjGA3I%2Fuploads%2F2izi9oSk1DdjPPBaMWJZ%2Fimage.png?alt=media&#x26;token=0027dfdd-3882-4dcd-a8fe-4f20ba8711e2" alt=""><figcaption></figcaption></figure>


---

# 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.kby-ai.com/help/demo-projects/server-windows-linux/facelivenessdetection-windows.md?ask=<question>
```

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.