# FaceRecognition - Windows

## Overview

This is the `Face Recognition Python` project for `Windows` machine.

It stands for `face recognition python`, `facial recognition python`, `face liveness check python`, `spoofing prevention python`, `face matching python`, `face comparison python`, `face search engine python`, `face identification python` on `Windows` server.

## SDK

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

## Github

{% embed url="<https://github.com/kby-ai/FaceRecognition-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%2FNUmFrleazdRlD4KTAt3U%2Fimage.png?alt=media&#x26;token=2facf6ce-3b29-4f90-b530-8a816ab4d510" 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/compare\_face](http://18.221.33.238:8081/compare_face)
* Test with a `base64-encoded` image: Send a `POST` request to <http://18.221.33.238:8081/compare_face_base64>
* You can download the `Postman` collection to easily access and use these `endpoints`. [click here](https://github.com/kby-ai/FaceRecognition-Docker/tree/main/postman/kby-ai-face.postman_collection.json)

<figure><img src="https://2589216230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WwtQK0VFwKRGmIjGA3I%2Fuploads%2Frd10ypFBGD2lT90R5pJW%2Fimage.png?alt=media&#x26;token=2fb386f6-5a51-48db-9166-5ea7365a25fc" alt=""><figcaption></figcaption></figure>

## How to Run

### 1. System Requirements

**CPU:** 2 cores or more (Recommended: 2 cores)

**RAM:** 4 GB or more (Recommended: 8 GB)

**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. Setup and Test

* Clone the project:

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

* Download the model from `Google Drive` and unzip it: [click here](https://drive.google.com/file/d/19vA7ZOlo19BcW8v4iCoCGahUEbgKCo48/view?usp=sharing)
* 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%2FSbDYQOkO72rWadIsTwWq%2Fimage.png?alt=media&#x26;token=04761fbd-35c5-43ed-9341-a45c223b8ae9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2589216230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WwtQK0VFwKRGmIjGA3I%2Fuploads%2FTAZsXHvyhpiArFu9NPyI%2Fimage.png?alt=media&#x26;token=b111d4c4-c71e-48de-a3d5-13c1897841c6" 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/facerecognition-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.