uniface/docs/index.md

hide, template

hide	template
toc navigation edit	home.html

UniFace

A Unified Face Analysis Library for Python

Get Started{ .md-button .md-button--primary } View on GitHub{ .md-button }

### :material-face-recognition: Face Detection RetinaFace, SCRFD, and YOLO detectors with 5-point landmarks.

### :material-account-check: Face Recognition AdaFace, ArcFace, EdgeFace, MobileFace, and SphereFace embeddings for identity verification.

### :material-map-marker: Landmarks Accurate 106-point facial landmark localization for detailed face analysis.

### :material-account-details: Attributes Age, gender, race (FairFace), and emotion detection from faces.

### :material-face-man-shimmer: Face Parsing BiSeNet semantic segmentation with 19 facial component classes.

### :material-eye: Gaze Estimation Real-time gaze direction prediction with MobileGaze models.

### :material-axis-arrow: Head Pose 3D head orientation (pitch, yaw, roll) estimation with 6D rotation models.

### :material-motion-play: Tracking Multi-object tracking with BYTETracker for persistent face IDs across video frames.

### :material-shield-check: Anti-Spoofing Face liveness detection with MiniFASNet to prevent fraud.

### :material-blur: Privacy Face anonymization with 5 blur methods for privacy protection.

### :material-database-search: Vector Indexing FAISS-backed embedding store for fast multi-identity face search.

---

Installation

UniFace uses portable model runtimes for consistent inference across macOS, Linux, and Windows. Most core components run through ONNX Runtime, while optional components may use PyTorch where appropriate.

CPU / Apple Silicon

pip install uniface[cpu]

GPU (NVIDIA CUDA)

pip install uniface[gpu]

From Source

git clone https://github.com/yakhyo/uniface.git
cd uniface
pip install -e ".[cpu]"   # or .[gpu] for CUDA

---

Next Steps

### :material-rocket-launch: Quickstart Get up and running in 5 minutes with common use cases.

Quickstart Guide →

### :material-school: Tutorials Step-by-step examples for common workflows.

View Tutorials →

### :material-api: API Reference Explore individual modules and their APIs.

Browse API →

### :material-book-open-variant: Guides Learn about the architecture and design principles.

Read Guides →

---

License

UniFace is released under the MIT License.