ageitgey/face_recognition
The world's simplest facial recognition api for Python and the command line
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
You can also read a translated version of this file in Chinese 简体中文版 or in Korean 한국어 or in Japanese 日本語. Recognize and manipulate faces from Python or from the command line with the world's simplest face recognition library. Built using dlib's state-of-the-art face recognition built with deep learning. The model has an accuracy of 99.38% on the Labeled Faces in the Wild benchmark (see the LFW paper (PDF)). This also provides a simple facerecognition command line tool that lets you do face recognition on a folder of images from the command line! [](https://pypi.python.org/pypi/facerecognition) [](https://github.com/ageitgey/facerecognition/actions?query=workflow%3ACI) [](http://face-recognition.readthedocs.io/en/latest/?badge=latest) Find all the faces that appear in a picture: Get the locations and outlines of each person's eyes, nose, mouth and chin. Finding facial features is super useful for lots of important stuff. But you can also use it for really stupid stuff like applying digital make-up (think 'Meitu'): Recognize who appears in each…
Read the full README ↗ · Preview checked 2026-10-30T22:32:09.441Z
Inside the original README — Document outline
- Face Recognition
- Features
- Find faces in pictures
- Find and manipulate facial features in pictures
- Identify faces in pictures
- Online Demos
- Installation
- Requirements
- Installation Options:
- Installing on Mac or Linux
- facelocations is now an array listing the co-ordinates of each face!
- facelocations is now an array listing the co-ordinates of each face!
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
The world's simplest facial recognition api for Python and the command line
Repository facts
- Owner
- ageitgey
- Primary language
- Python
- Stars
- 56,866
- Forks
- 13,669
- Open issues + pull requests
- 833
- License
- MIT
- Archived
- No
- Default branch
- master
- Created
- 2017-03-03T21:52:39.000Z
- Last push
- 2026-06-25T11:12:50.000Z
Topics and intended use
Owner-supplied topics: face-detection, face-recognition, machine-learning, python
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-31T12:19:22.904Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.
Related repositories
EbookFoundation/free-programming-books
donnemartin/system-design-primer