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

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