ageitgey/face_recognition

The world's simplest facial recognition api for Python and the command line

Open original source ↗

From the publisher

README & documentation

Source preview

Read 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…

ageitgey/face_recognition on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-10-30T22:32:09.441Z

Inside the original README — Document outline
  1. Face Recognition
  2. Features
  3. Find faces in pictures
  4. Find and manipulate facial features in pictures
  5. Identify faces in pictures
  6. Online Demos
  7. Installation
  8. Requirements
  9. Installation Options:
  10. Installing on Mac or Linux
  11. facelocations is now an array listing the co-ordinates of each face!
  12. 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,862
Forks
13,667
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.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-11-01T12:19:42.808Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

public-apis/public-apis

EbookFoundation/free-programming-books

donnemartin/system-design-primer

vinta/awesome-python

practical-tutorials/project-based-learning

NousResearch/hermes-agent