1adrianb/face-alignment

Health v2 · maintenance only

Adoption not part of the score

7538 stars · 1383 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A Python library built on PyTorch that detects 2D and 3D facial landmarks in images using the FAN deep learning face alignment network. It supports multiple pluggable face detectors (SFD, BlazeFace, YuNet, RetinaFace, SCRFD) and batch processing of directories.

Use cases

• detect facial landmarks in photos
• extract 3D face keypoints from images
• face alignment preprocessing for face recognition pipelines
• batch process a folder of images for face landmarks
• swap face detector backends for speed vs accuracy
• run face landmark detection on GPU or CPU

When to choose

• you need accurate 2D or 3D facial landmark detection in Python
• you want a PyTorch-based, pip-installable face alignment solution
• you need to choose between accuracy- and speed-optimized face detectors

When to avoid

• you need real-time video landmark tracking at high frame rates on CPU
• you need full face recognition or identification rather than landmark detection
• you work outside the Python/PyTorch ecosystem

Facets

library · maturity active

computer-vision image-processing machine-learning deep-learning computer-vision deep-learning image-processing python cross-platform facial-landmarks face-detection pytorch 2d-3d-landmarks face-alignment gpu

Member repositories

For agents

markdown · JSON · MCP: product_card(name="1adrianb/face-alignment")