uniface README

README проекта с github.com/yakhyo/uniface. Одним файлом markdown: README.md.

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 and landmarks are always set, and embedding is set whenever a recognizer runs, which is the default. Age, sex, race, emotion 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, AuraFace, EdgeFace, HyperFace, 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, MobileOne-S0)
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.

uniface (yakhyo/uniface)

Ищем в базе…

2.3K ·GitHub
Что это такое?UniFace — это единая библиотека для Python, которая объединяет пятнадцать задач анализа лиц (обнаружение, распознавание, ключевые точки, парсинг, направление взгляда, атрибуты, защита от подделки и другие) через один API, так что отдельный пакет под каждую задачу не нужен.
Это полноценный фреймворк или скорее набор инструментов, который я импортирую в свой код?Это библиотека для Python, которую вы импортируете и вызываете напрямую: класс FaceAnalyzer выполняет обнаружение, выравнивание и распознавание одним вызовом, а дополнительные модели атрибутов подключаются по желанию.
Как начать работу?Подключите UniFace как пакет Python и запустите FaceAnalyzer на изображении; по умолчанию возвращаются bbox, confidence, landmarks и embedding, а любой из остальных четырнадцати предикторов добавляете по необходимости.
Все пятнадцать задач работают сразу после установки?Базовые обнаружение, выравнивание и распознавание запускаются по умолчанию, но дополнительные проверки — возраст, пол, раса, эмоции, качество и состояние лица — остаются None, пока вы явно не передадите соответствующий предиктор.
Весь проект можно бесплатно использовать в коммерческих целях?Код UniFace распространяется по лицензии MIT, но у некоторых предобученных весов моделей другие лицензии, поэтому перед коммерческим выпуском их нужно проверить.
Какие модели используются для обнаружения и распознавания лиц?Для обнаружения можно использовать RetinaFace, SCRFD, CenterFace, YOLOv5-Face, YOLOv8-Face или BlazeFace, а для распознавания — AdaFace, ArcFace, EdgeFace, MobileFace или SphereFace.
Может ли он отслеживать лица в видео, а не только в отдельных кадрах?Да, в комплекте есть BYTETracker для трекинга лиц: он сохраняет постоянные ID одного и того же лица на протяжении кадров видео.
Можно ли искать совпадающие лица, когда у меня уже есть эмбеддинги?Да, для поиска по эмбеддингам встроено векторное хранилище на основе FAISS, так что можно находить лица и сопоставлять их по схожести.
Как работает анонимизация лиц?Доступно пять разных методов размытия для анонимизации обнаруженных лиц, что удобно для конвейеров обработки изображений и видео с защитой приватности.
Автор
yakhyo
Размер
121.4 MB
Звёзды
2.3K
Возраст
2 г
Коммиты · 90 дней