---
id: facexlib
version: "0.3.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: dormant
---

# facexlib — Basic face library

License: permissive · Maintenance: dormant · Downloads: 1.2M/mo

## What it is and what it does

Facexlib is a collection library that wraps state-of-the-art open-source face analysis algorithms into a unified PyTorch interface. It provides nine face-related capabilities—detection, alignment, recognition, parsing, matting, head pose estimation, tracking, quality assessment, and utility helpers—each sourced from a different reference implementation and aggregated under one package.

The library is designed for practitioners who need ready-to-use face functions without implementing each algorithm from scratch. It handles pre-trained model management automatically, downloading weights on first use. Because it aggregates multiple algorithms with different original licenses (MIT, Apache 2.0, CC 4.0, GPL 3.0), users must verify the license terms of each function they use against their intended application.

Use it for:

- Build a face detection and alignment pipeline for preprocessing images before feeding to downstream models.
- Perform face recognition or identity verification using the integrated InsightFace algorithm.
- Segment facial regions (parsing) to identify eyes, nose, mouth, and other anatomical parts.
- Estimate head pose angles for gaze direction or 3D face reconstruction tasks.
- Track faces across video frames using the integrated SORT tracker.
- Assess face image quality to filter low-quality samples before processing.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Facexlib provides a collection of PyTorch-based face analysis functions including detection, alignment, recognition, parsing, matting, head pose estimation, tracking, and quality assessment.

Yes, if you need multiple face analysis functions and can accept dormant maintenance. The package offers genuine convenience by aggregating well-known algorithms into one interface with low install friction. However, verify that the original licenses of the specific functions you use align with your project, and be aware that no active development means you may need to fork or patch for compatibility with newer PyTorch or CUDA versions.

## Install

pip install facexlib
uv add facexlib
poetry add facexlib

## Installing facexlib

Before you install: Low install friction with a pure-Python wheel. Dormant maintenance (last commit 2024-02-29, 1217 days since release) means no recent updates, though the repository remains active with 976 stars. Expect to manage pre-trained model downloads yourself if network connectivity is unreliable.

License in practice: Released under Apache License 2.0 (permissive). However, the package aggregates algorithms from multiple sources with different licenses (MIT, Apache 2.0, CC 4.0, GPL 3.0); you must review the original licenses of the specific functions you use, as noted in the documentation.

Quickstart:

pip install facexlib

import facexlib
# Pre-trained models download automatically on first use
# Example: detector = facexlib.detection.init_detection_model(...)

PyTorch >= 1.7 required; Python >= 3.7 recommended. Pre-trained models download automatically on first inference; stable network connection recommended.

Verify before relying:

- Whether pre-trained model downloads work reliably from current sources or if mirrors/fallbacks are needed.
- Compatibility with PyTorch versions beyond 1.7 and current CUDA releases.
- Performance and accuracy of each function relative to their original implementations.

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 1.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

face detection and alignment, face recognition pytorch, facial landmark detection, face parsing segmentation, head pose estimation, face tracking, face quality assessment, face-analysis, computer-vision, pytorch

[View on SkillFed](https://skillfed.io/packages/facexlib) · [View on PyPI](https://pypi.org/project/facexlib/)