ageitgey/face_recognition

View on GitHub

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

Is ageitgey/face_recognition beginner-friendly?

We have not seen enough recent pull requests from outside contributors to ageitgey/face_recognition to say how often they are merged. 1 beginner-friendly issue is open now.

Stars: 56.8k
Forks: 13.7k
Open beginner issues: 1
Indexed issues: 776

Dominant language: Python
License: MIT
Last GitHub push: Jun 25, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed
PR merge metrics: No merged PRs in 30d

How to contribute to ageitgey/face_recognition

Read the contributing guide first: it says how the maintainers want changes proposed, tested and reviewed.
It ships a Dockerfile or Docker Compose file, so you can run it without installing its whole toolchain.
Your contributions will be published under the project's MIT license.
Pick the open beginner-friendly issue below and comment that you want to work on it before you start.

Beginner friendly Everything

Open All

Issues somebody may already be working on are listed last. List everything by date

[Security] Automated static analysis findings for ageitgey/face_recognition (academic research)
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 20/100

ageitgey/face_recognition#1681 · 1 comment · Opened Oct 21, 2026
Honest-Feedback
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 45/100

ageitgey/face_recognition#1669 · 3 comments · Opened Feb 7, 2026
AiSoul
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 20/100

ageitgey/face_recognition#1668 · 1 comment · Opened Jan 28, 2026
Multiprocessing output can be interleaved/jumbled due to direct print calls in worker process
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 76/100

ageitgey/face_recognition#1665 · 2 comments · Opened Nov 25, 2025
Misuse of quit() in api.py; Use of SystemExit(1) + narrow exception handling
Open
- Is something wrong?
Difficulty 1/5 1-3 hours Newbie friendliness 50/100

ageitgey/face_recognition#1663 · Opened Nov 15, 2025
The pkg_resources package is slated for removal as early as 2025-11-30
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 35/100

ageitgey/face_recognition#1653 · 1 comment · 5 reactions · Opened Aug 12, 2025
Embedding normalisation
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1651 · 1 comment · Opened Jul 11, 2025
SHA hash mismatch (altered files?) when installing from pip3 from piwheels
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 30/100

ageitgey/face_recognition#1644 · Opened May 27, 2025
please help me out
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 15/100

ageitgey/face_recognition#1642 · 1 comment · Opened May 15, 2025
RuntimeError: Error while calling cudaOccupancyMaxPotentialBlockSize(&num_blocks,&num_threads,K)
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1641 · 2 comments · Opened May 13, 2025
I want to solve this problem
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 15/100

ageitgey/face_recognition#1640 · 2 comments · Opened Apr 29, 2025
Why I'm getting this error?
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 38/100

ageitgey/face_recognition#1639 · 2 comments · Opened Apr 28, 2025
Installation error
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 35/100

ageitgey/face_recognition#1638 · 3 comments · Opened Apr 14, 2025
errors
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 15/100

ageitgey/face_recognition#1636 · 1 comment · Opened Apr 11, 2025
Error showing Please install `face_recognition_models` with this command before using `face_recognition .
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1634 · 5 comments · 1 reaction · Opened Mar 26, 2025
Looking to contribute
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 10/100

ageitgey/face_recognition#1633 · Opened Mar 18, 2025
ModuleNotFoundError: No module named 'pydantic_settings'
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 20/100

ageitgey/face_recognition#1632 · Opened Mar 15, 2025
Spanish Translate
Open
- Is something wrong?
Difficulty 1/5 1-3 hours Newbie friendliness 48/100

ageitgey/face_recognition#1631 · Opened Mar 13, 2025
Dlib installation Error
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 15/100

ageitgey/face_recognition#1630 · Opened Mar 12, 2025
issue on colab, was working fine 50 days ago, today when I run the same notebook again, I get this error.
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 30/100

ageitgey/face_recognition#1628 · 3 comments · Opened Feb 21, 2025
C++ version pls
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 10/100

ageitgey/face_recognition#1623 · Opened Dec 24, 2024
Getting accuracy of 94% while doing cosine simmilarity on face encodings
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 30/100

ageitgey/face_recognition#1621 · Opened Dec 16, 2024
RuntimeError: Unsupported image type, must be 8bit gray or RGB image.
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 32/100

ageitgey/face_recognition#1618 · 2 comments · Opened Nov 25, 2024
Closes Program
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1614 · 2 comments · Opened Oct 31, 2024
How I can create a separate encoding for each face in an image
May be free again @Tanishq1030 claimed this 588 days ago, and no pull request is open. Open
- Is something wrong?
Difficulty 2/5 1-3 hours Newbie friendliness 25/100

ageitgey/face_recognition#1613 · 2 comments · Opened Oct 5, 2024
Error loading images or encoding faces: Unsupported image type, must be 8bit gray or RGB image.
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 15/100

ageitgey/face_recognition#1612 · 8 comments · Opened Sep 26, 2024
import face_recognition ModuleNotFoundError: No module named 'face_recognition'
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 15/100

ageitgey/face_recognition#1611 · 5 comments · Opened Sep 14, 2024
error: (-215:Assertion failed) !_src.empty() in function 'cv::cvtColor'
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 25/100

ageitgey/face_recognition#1609 · Opened Sep 9, 2024
Openface 128d embedding not match with same trained image
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1607 · Opened Sep 5, 2024
Issue with Identifying Partial Faces Using face_recognition Library
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 20/100

ageitgey/face_recognition#1585 · 1 reaction · Opened Sep 2, 2024
compute_face_descriptor(): incompatible function arguments
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 32/100

ageitgey/face_recognition#1582 · 8 comments · Opened Aug 16, 2024
How to recall the miss detected face?
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1581 · 1 comment · Opened Aug 7, 2024
Package installed and verified but ModuleNotFoundError when running app - M2
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 20/100

ageitgey/face_recognition#1580 · Opened Aug 6, 2024
Does locating the face first then encoding the face have higher accuracy than just encoding the face?
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1579 · Opened Aug 2, 2024
File "C:\Users\hp\PycharmProjects\face-reco-attendence\.venv\Lib\site-packages\face_recognition\api.py", line 105, in _raw_face_locations return face_detector(img, number_of_times_to_upsample) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ RuntimeError: Unsupported image type, must be 8bit gray or RGB image.
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 20/100

ageitgey/face_recognition#1578 · 1 comment · Opened Jul 30, 2024
reconnaissance faciale
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 20/100

ageitgey/face_recognition#1577 · Opened Jul 23, 2024
Error: libcublasLt.so.11: cannot open shared object file: No such file or directory
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1576 · Opened Jul 19, 2024
Error during face recognition: Unsupported image type, must be 8bit gray or RGB image.
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 32/100

ageitgey/face_recognition#1574 · 3 comments · Opened Jun 27, 2024
RuntimeError: Unsupported image type, must be 8bit gray or RGB image.
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 28/100

ageitgey/face_recognition#1573 · 45 comments · 9 reactions · Opened Jun 22, 2024
Why This Project Not Updated
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 15/100

ageitgey/face_recognition#1571 · 5 comments · 1 reaction · Opened Jun 6, 2024
when I ran facerec_from_video_file.py，I can not find output.avi anywhere
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 25/100

ageitgey/face_recognition#1568 · Opened May 29, 2024
Dockerfile python version
Open
- Is something wrong?
Difficulty 2/5 1-3 hours Newbie friendliness 35/100

ageitgey/face_recognition#1567 · Opened May 28, 2024
Face recognition
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 10/100

ageitgey/face_recognition#1565 · 1 comment · Opened May 26, 2024
ModuleNotFoundError: No module named 'face_recognition'
Open
- Is something wrong?
Difficulty 3/5 1-2 days Newbie friendliness 20/100

ageitgey/face_recognition#1564 · 4 comments · Opened May 10, 2024
Face Recognition not installing on raspberry pi 3
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1563 · 1 comment · Opened Apr 27, 2024
Face recorgon
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 5/100

ageitgey/face_recognition#1562 · Opened Apr 21, 2024
Will your face_recognition application allow me to store pictures with names tide to them and just later down the line submit a new photo of someone who i dont remember i actually stored, and then the application when i send the photo identifies the person in the photo because its the exact person i stored of their name in a different photo i have saved?
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 20/100

ageitgey/face_recognition#1561 · 1 comment · Opened Apr 18, 2024
image de-duplication by comparing faces images.
Open
- Is something wrong?
Difficulty 5/5 Over a week Newbie friendliness 20/100

ageitgey/face_recognition#1560 · Opened Apr 16, 2024
dlib
Open
- Is something wrong?
Difficulty 4/5 3-5 days Newbie friendliness 25/100

ageitgey/face_recognition#1559 · 3 comments · Opened Mar 14, 2024
Attribute error
Open
- Is something wrong?
Difficulty 2/5 1-3 hours Newbie friendliness 15/100

ageitgey/face_recognition#1556 · 1 comment · Opened Feb 19, 2024

Showing the newest 100

This page lists what was indexed most recently. Advanced filter has the whole inventory, narrowed by language, difficulty and how long a task takes.

Open advanced filter

ageitgey/face_recognition

Is ageitgey/face_recognition beginner-friendly?

How to contribute to ageitgey/face_recognition

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Showing the newest 100

Get new issues in your inbox