How ageitgey/face_recognition works
Face Recognition is a Python library and pair of command-line tools for detecting faces, extracting facial features and encodings, and matching faces. In the Python workflow, a caller loads an image, detects faces, optionally gets landmarks and encodings, then compares encodings. The recognition CLI builds known-person encodings from filenames and tests unknown images; a separate CLI reports face coordinates. The API delegates detection and landmark prediction to dlib. Source excerpts establish these calls, but do not show every model initialization or the full implementation.
Main entry points: api.py Landmark extraction · face_recognition_cli.py Unknown image test · face_detection_cli.py Detection image test
Components 14
User interfaces
- Recognition CLI
face_recognition/face_recognition_cli.py - Known face scan
face_recognition/face_recognition_cli.py - Unknown image test
face_recognition/face_recognition_cli.py - Detection CLI
face_recognition/face_detection_cli.py - Detection image test
face_recognition/face_detection_cli.py
Face analysis
- Image loading
face_recognition/api.py - Face detection
face_recognition/api.py - Landmark extraction
face_recognition/api.py
Face matching
- Face encoding
face_recognition/api.py - Face comparison
face_recognition/api.py
Other components
- Python caller
- CLI user
- dlib
- Face models
Connections 23
- Python caller → Image loading: loads image
README.md - Python caller → Face detection: requests locations
README.md - Python caller → Landmark extraction: requests landmarks
README.md - Python caller → Face encoding: requests encodings
README.md - Python caller → Face comparison: compares faces
README.md - CLI user → Recognition CLI: runs command
README.md - CLI user → Detection CLI: runs command
README.md - Recognition CLI → Known face scan: scans known faces
face_recognition/face_recognition_cli.py - Recognition CLI → Unknown image test: tests images
face_recognition/face_recognition_cli.py - Known face scan → Image loading: loads images
face_recognition/face_recognition_cli.py - Known face scan → Face encoding: encodes faces
face_recognition/face_recognition_cli.py - Unknown image test → Image loading: loads image
face_recognition/face_recognition_cli.py - Unknown image test → Face encoding: encodes faces
face_recognition/face_recognition_cli.py - Unknown image test → Face comparison: gets distances
face_recognition/face_recognition_cli.py - Detection CLI → Detection image test: processes images
face_recognition/face_detection_cli.py - Detection image test → Image loading: loads image
face_recognition/face_detection_cli.py - Detection image test → Face detection: gets locations
face_recognition/face_detection_cli.py - Landmark extraction → Face detection: locates faces
face_recognition/api.py - Face encoding → Landmark extraction: uses landmarks
face_recognition/api.py - Face detection → dlib: dispatches detection
face_recognition/api.py - Landmark extraction → dlib: predicts landmarks
face_recognition/api.py - Face detection → Face models: uses detector model
- Landmark extraction → Face models: loads predictor model
face_recognition/api.py