Guides

Deployment & Integration Guides

Practical tutorials for self-hosting InsightFace Server, integrating its REST API and Python SDK, and converting, deploying, or validating face models.

InsightFace ServerDockerFace RecognitionCUDASelf-hosted

Deploy InsightFace Server with Docker

Deploy InsightFace Server on CPU or CUDA with Docker, install a licensed model, run your first exact 1:N search, and secure persistent data.

10 min readRead guide
InsightFace ServerREST APIPython SDKFace RecognitionRTSP

Integrate InsightFace Server REST API and Python SDK

Integrate InsightFace Server with its REST API or Python SDK: create Collections, enroll identities, run exact 1:N search, retry safely, and monitor RTSP.

16 min readRead guide
InsightFace 1.0GUIFace RecognitionEvaluationFace Swap

InsightFace 1.0 Tutorial: Local Face Recognition, Desktop GUI, and Enterprise Evaluation

Install the lighter InsightFace 1.0 package, launch the cross-platform Evaluation Studio, run local recognition workflows, organize albums, evaluate identity-folder datasets, and understand model licensing and privacy boundaries.

11 min readRead guide
Private Model TestFace RecognitionEvaluationMOUPrivacy

How to Run a Private InsightFace Recognition Model Test

A step-by-step guide for evaluators to benchmark InsightFace open-source and private recognition models against their own data, covering MOU prerequisites, image preparation, the Python client, and privacy controls.

8 min readRead guide
Face Recognition1:1 Verification1:N IdentificationFRVTBenchmarkThreshold

Choosing a Face Recognition Model: 1:1, 1:N Testing, and Threshold Selection

A FRVT-aligned framework for choosing an InsightFace recognition model, building 1:1 and 1:N benchmarks, picking thresholds, and deciding when to upgrade from open-source packs to InsightFace commercial models.

14 min readRead guide
ONNXTensorRTOpenVINODeployment

Convert ONNX Face Models to TensorRT and OpenVINO

A production-oriented guide for converting InsightFace-style ONNX models into TensorRT engines and OpenVINO IR, with validation, precision choices, benchmarking, and deployment checks.

12 min readRead guide