Windows

Faceplugin Face Recognition SDK Windows — recognition and face liveness in one process. HTTP API on port 8083 including POST /api/liveness. No Docker.

Fully on-premise Face Recognition + Face Liveness HTTP API for Windows in one process. Default port 8083. Gradio 9003. No Docker on Windows.

One wrapper (FaceRecognitionSDK.dll), one license, two model packs (far.fpk + fal.fpk). Your license can unlock Recognition only, Liveness only, or both.

This is not the recognition-only Face Recognition Windows SDK. It is not the anti-spoofing-only Face Liveness Detection Windows SDK (port 8084). Do not copy two products’ Google Drive runtimes into one lib\cpu\ folder.

For Docker combined, use Face Recognition + Liveness Linux SDK (faceplugin/face-recognition-liveness-sdk).

All processing stays on your machine. No biometric data is sent to Faceplugin cloud.

Code

https://github.com/Faceplugin-ltd/FaceRecognitionSDK-Windowsgithub.com

Setup

Sizing: Hosting requirements.

1

Copy the runtime

Copy the CPU libraries from Google Drive into lib\cpu\ (see the repo README for the current folder link).

2

Install and run

pip install -r requirements.txt
run.bat

3

Copy the machine code

curl -s http://127.0.0.1:8083/api/machinecode

Send machine code to Faceplugin. Copy it from the terminal if curl is not available.

4

Activate

curl -s -X POST http://127.0.0.1:8083/api/activate \
  -H 'Content-Type: text/plain' \
  --data-binary @license.txt

Some routes wrap the result in a small JSON object (an envelope). Process POSTs return engine JSON as the body. Port 8083 is shared with recognition-only — run one Face Recognition HTTP service at a time.

APIs

Same recognition routes as Face Recognition Windows SDK, plus liveness:

Endpoint	Purpose
GET /api/health	Process is listening (no license)
GET /api/machinecode	Machine code
GET /api/licenseStatus	License capabilities
GET /api/backend	"cpu"
POST /api/activate	Activate and init
POST /api/detect	Detect faces
POST /api/quality	Quality checks
POST /api/feature	Extract template
POST /api/match	Compare two photos
POST /api/similarity	Compare two templates
POST /api/liveness	Passive face anti-spoofing

Full reference: Face Recognition HTTP API. Liveness: Face Liveness HTTP API. Shared control routes: Shared endpoints.

There is no POST /api/identify (no server-side 1:N gallery).

Try it

curl -s http://127.0.0.1:8083/api/health
IMG=$(base64 -w0 face.jpg)

curl -s -X POST http://127.0.0.1:8083/api/detect \
  -H 'Content-Type: application/json' \
  -d "{\"image\":\"$IMG\"}"

curl -s -X POST http://127.0.0.1:8083/api/liveness \
  -H 'Content-Type: application/json' \
  -d "{\"image\":\"$IMG\"}"

Local Gradio: run_demo.bat on 9003 (Detect, Quality, Match, Liveness).

FAQ

Is this one Windows process for recognition and liveness? Yes. Public repo FaceRecognitionSDK-Windows, including POST /api/liveness.

Prefer two separate products? Use Face Recognition Windows on 8083 and Face Liveness Windows on 8084.

Related documentation

• Face Recognition Windows SDK (recognition only) · Glossary

• Face Recognition + Liveness Linux SDK

• Face Liveness Detection Windows SDK

• Face Recognition Server SDK · Choose a product

• Request a License · Status codes