# serengil/retinaface

RetinaFace: Deep Face Detection Library for Python

Repository: https://github.com/serengil/retinaface
Canonical: https://ross.abutalabs.com/products/retinaface
Homepage: https://www.youtube.com/watch?v=Wm1DucuQk70&list=PLsS_1RYmYQQFdWqxQggXHynP1rqaYXv_E&index=3
Language: Python
License: MIT
License Family: permissive
Topics: face-detection, retinaface, retinaface-detector, python, tensorflow, face-recognition, face-alignment, insightface, face-detector
Last push: 2026-06-01T13:44:09+00:00

## Health v2 (maintenance only)
Score: 61/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 85, release rhythm 8, longevity 100
- inputs: {"age_days": 1956, "days_push": 93, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2027, forks 199 (observed 2026-08-28T04:06:06.946596+00:00)

## What it is
RetinaFace is a Python library for deep learning based face detection, built on TensorFlow and derived from the insightface project's RetinaFace detector. It returns facial area coordinates, confidence scores, and facial landmarks (eyes, nose, mouth), and supports face alignment for recognition pipelines.

## Use cases
- detect faces in images with python
- find facial landmarks like eyes nose and mouth
- align faces before running face recognition
- detect faces in crowded photos
- get bounding boxes of faces in an image
- build a face recognition pipeline in python

## When to choose
- you need accurate face detection with landmarks in Python
- you want a pip-installable TensorFlow reimplementation of RetinaFace
- you need face alignment as a preprocessing step for recognition

## When to avoid
- you need real-time video face detection on low-power devices
- you need multi-framework support beyond TensorFlow
- you need full face recognition rather than detection

## Facets
- artifact type: library
- maturity: active
- function: computer-vision, image-processing, machine-learning, deep-learning
- domain: computer-vision, image-processing, artificial-intelligence, deep-learning
- platform: python, cross-platform
- tags: face-detection, facial-landmarks, face-alignment, retinaface, tensorflow, insightface, face-recognition

## Member repositories
- serengil/retinaface (main) score 61

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:06.946596+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:59:42.275894+00:00, confidence not recorded.
  - readme: https://github.com/serengil/retinaface (fetched 2026-08-28T04:06:06.946596+00:00, sha 79d4a8e4f64b)
  - homepage: https://www.youtube.com/watch?v=Wm1DucuQk70&list=PLsS_1RYmYQQFdWqxQggXHynP1rqaYXv_E&index=3 (fetched 2026-08-29T10:39:49.117468+00:00, sha 44136fa355b3)
- Data as of 2026-08-30T08:39:29.467469+00:00.