Skip to main content

UniFace

A Unified Face Analysis Library for Python

English · 简体中文 · 한국어 · Oʻzbekcha

PyPI Version Python Version License GitHub Build Status PyPI Downloads Kaggle Badge Hugging Face Spaces

UniFace is a lightweight, production-ready Python library for face detection, recognition,
tracking, landmarks, face mesh, parsing, gaze, attributes, anti-spoofing and more.

Get Started   Model Zoo   Notebooks   Full Docs

UniFace running face detection, landmarks, face mesh, tracking, recognition, attributes, head pose, face parsing and anonymization on video
Nine of the fifteen tasks, one library. Every overlay is UniFace output, rendered frame by frame.

pip install "uniface[cpu]"          # CPU and Apple Silicon
pip install "uniface[gpu]"          # NVIDIA CUDA
pip install --pre "uniface[cpu]"    # latest pre-release

A first script

FaceAnalyzer runs detection, alignment and recognition in one call. Attribute models are opt-in.

import cv2
from uniface import FaceAnalyzer, FairFace

analyzer = FaceAnalyzer(predictors=[FairFace()])

for face in analyzer.analyze(cv2.imread("photo.jpg")):
    print(face.bbox, face.sex, face.age_group, face.embedding.shape)

bbox, confidence, landmarks and embedding are always set. Age, sex, race, emotion, quality and the face states stay None until you pass the predictor that fills them.

All fifteen tasks, and which model does each
Task Models
Face Detection RetinaFace, SCRFD, CenterFace, YOLOv5-Face, YOLOv8-Face, BlazeFace
Face Recognition AdaFace, ArcFace, EdgeFace, MobileFace, SphereFace
Face Tracking BYTETracker, persistent IDs across video frames
Facial Landmarks 2d106det (106), PIPNet (98 / 68), Face Mesh (468 / 478, 3D)
Face Parsing BiSeNet (19 classes), XSeg masking
Portrait Matting MODNet, PP-Matting (v1 HRNet-W18, v2 STDC1), trimap-free
Gaze Estimation MobileGaze (ResNet-18 / 34 / 50, MobileNetV2)
Head Pose 6D rotation representation, pitch / yaw / roll
Demographics AgeGender, FairFace (age group, sex, race)
Emotion AffectNet-7 and AffectNet-8
Face States FaceAttribNet: eyes, glasses, sunglasses, mask
Face Quality eDifFIQA (T / S / M / L)
Anti-Spoofing MiniFASNet liveness
Anonymization 5 blur methods
Vector Store FAISS-backed embedding search

Runs on CPU, Apple Silicon and CUDA. Weights download on first use.


Find and measure faces

Face Detection  ·  docs

Facial Landmarks  ·  docs

Face Mesh  ·  docs

Face Quality  ·  docs

Cut faces out

Face Parsing  ·  docs

Face Segmentation  ·  docs

Portrait Matting  ·  docs

Read where a head is pointing

Head Pose  ·  docs

Gaze Estimation  ·  docs

Read a face

Age and Sex  ·  docs

Emotion  ·  docs

Face States  ·  docs

Tell a real face from a replay

Anti-Spoofing  ·  docs

Match a face, or hide one

Face Recognition  ·  docs

Face Anonymization  ·  docs


Contributing  ·  Issues

UniFace is MIT; some pretrained weights are not, so check licences before shipping commercially.
Not affiliated with Uniface by Rocket Software.

Metadata

Release files for uniface 4.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for uniface 4.3.0
File Size Uploaded Provenance Actions
uniface-4.3.0.tar.gz 137.9 kB With provenance Details for uniface-4.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for uniface 4.3.0
File Interpreter ABI Platform Actions
uniface-4.3.0-py3-none-any.whl Python 3 none any Details for uniface-4.3.0-py3-none-any.whl

Total release size: 301.3 kB

Release files / uniface-4.3.0.tar.gz

Download URL uniface-4.3.0.tar.gz
Size 137.9 kB
Tags Source
SHA-256 checksum
How to use checksums
718006fa937d0c35f42dc3cd1399c0fd3f30e02bb0a914a6bda9f5c60dee4536
BLAKE2b-256 checksum
How to use checksums
babbcd8998bc8e02c35c840a459f1e4c3ff92df6977b137fdd23c87dc47686af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / uniface-4.3.0-py3-none-any.whl

Download URL uniface-4.3.0-py3-none-any.whl
Size 163.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
49b7a45d09ee0a3107dec60fbfcba30d3860ab06425d1084a6ee107f8520dcb0
BLAKE2b-256 checksum
How to use checksums
e90d98f0e376c7a716a2018bfcaa1decf12638167086e42089c3f85475f7486e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for uniface 4.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for uniface-4.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

4.3.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page