RetinaFace, SCRFD, CenterFace, and YOLO detectors with 5-point landmarks, plus BlazeFace for short-range MediaPipe parity.
Face Recognition
AdaFace, ArcFace, EdgeFace, MobileFace, and SphereFace embeddings for identity verification.
Landmarks
Dense facial landmark localization — 106-point (2d106det), 98 / 68-point (PIPNet), and 468/478-point 3D mesh (Face Mesh, the 478 variant adding irises) variants.
Attributes
Age, gender, race (FairFace), emotion, and face states (FaceAttribNet) from faces.
Face Parsing
BiSeNet semantic segmentation with 19 facial component classes, plus XSeg face masking.
Portrait Matting
Trimap-free alpha matte with MODNet for background removal and compositing.
Gaze Estimation
Real-time gaze direction prediction with MobileGaze models.
Head Pose
3D head orientation (pitch, yaw, roll) estimation with 6D rotation models.
Tracking
Multi-object tracking with BYTETracker for persistent face IDs across video frames.
Anti-Spoofing
Face liveness detection with MiniFASNet to prevent fraud.
Face Quality
eDifFIQA scalar quality score to filter or rank faces before recognition.
Privacy
Face anonymization with 5 blur methods for privacy protection.
Vector Indexing
FAISS-backed embedding store for fast multi-identity face search.
Installation
UniFace runs out of the box on macOS, Linux, and Windows, with automatic hardware acceleration on Apple Silicon, NVIDIA CUDA, and CPU. Inference runs on ONNX Runtime (with PyTorch for a few optional models) — installed automatically by the extra you choose below.
CPU / Apple Silicon
pipinstall"uniface[cpu]"
GPU (NVIDIA CUDA)
pipinstall"uniface[gpu]"
From Source
gitclonehttps://github.com/yakhyo/uniface.git
cduniface
pipinstall-e".[cpu]"# or .[gpu] for CUDA
Next Steps
Quickstart
Get up and running in 5 minutes with common use cases.
Tutorials
Step-by-step examples for common workflows.
API Reference
Explore individual modules and their APIs.
Guides
Learn about the architecture and design principles.
