ai-agent

Face Recognition with face_recognition

Name: Face Recognition with face_recognition
Author: ageitgey

Get simple facial recognition for your startup with face_recognition, used by 57k+ GitHub stars, for Python and command line.

56,570 stars13,696 forksPythonQuality 9/10Updated 6/25/2026100% free · open source

What it does

Face_recognition is a Python library that provides simple facial recognition capabilities, allowing you to identify and compare faces in images.

Install / run

pip install face_recognition

When to use it

•You need to authenticate users based on their facial identity
•You want to automate the process of tagging people in photos
•You're building a surveillance system that requires face detection and recognition

Quick start

1Clone the repository using `git clone https://github.com/ageitgey/face_recognition.git`
2Navigate to the examples directory using `cd face_recognition/examples`
3Run the face recognition example using `python face_recognition_example.py`
4Use the `face_locations` function to detect faces in an image, like this: `face_locations = face_recognition.face_locations(image)`
5Compare two faces using the `compare_faces` function, like this: `matches = face_recognition.compare_faces([face_encoding], face_encoding_to_check)`

Ready-to-paste prompt

python -m face_recognition `face_recognition examples/obama.jpg examples/biden.jpg -e`

Heads up: Make sure you have the dlib library installed, which is a requirement for face_recognition, and also ensure you're using a compatible version of OpenCV, as face_recognition uses it under the hood

Saves to your device