Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

[English] | [Chinese] | [Korean] | [Uzbek]

UniFace: A Unified Face Analysis Library for Python

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

UniFace - A Unified Face Analysis Library for Python

UniFace is a lightweight, production-ready Python library for face detection, recognition,
tracking, landmark analysis, face parsing, gaze estimation, and face attributes.

Get Started   Model Zoo   Notebooks   Full Docs

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, 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, verified by SHA-256.


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


Get Started  ·  Model Zoo  ·  Notebooks  ·  Model licences  ·  Contributing  ·  Discord  ·  Issues

Runs on CPU, Apple Silicon and CUDA. Weights download on first use, verified by SHA-256.
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.1.0rc1

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.1.0rc1
File Size Uploaded Provenance Actions
uniface-4.1.0rc1.tar.gz 135.3 kB Without provenance Details for uniface-4.1.0rc1.tar.gz

Built distribution (wheel)

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

Total release size: 295.9 kB

Release files / uniface-4.1.0rc1.tar.gz

Download URL uniface-4.1.0rc1.tar.gz
Size 135.3 kB
Tags Source
SHA-256 checksum
How to use checksums
959bcff88845934b2d764da7baa791c7cf8faa1568d8304518657ffb3480de10
BLAKE2b-256 checksum
How to use checksums
024ba740e4d58f0b1b1f738bdba993903586be019f35f659974892a1b475df22
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Release files / uniface-4.1.0rc1-py3-none-any.whl

Download URL uniface-4.1.0rc1-py3-none-any.whl
Size 160.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0c42fa6e7676809e2097145550d5cd437502c0706029d3ce62dd15d6b77788c1
BLAKE2b-256 checksum
How to use checksums
43699b72d729b8d990cda7b4a6ed651e891f50a9b71a944fd82b5de88c41b41d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Security for uniface 4.1.0rc1

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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
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