https://github.com/fathulfahmy/face-recognition
Real-time face recognition (DeepFace, OpenCV)
https://github.com/fathulfahmy/face-recognition
deepface face-recognition face-recognition-python facial-recognition machine-learning opencv opencv-python python
Last synced: 23 days ago
JSON representation
Real-time face recognition (DeepFace, OpenCV)
- Host: GitHub
- URL: https://github.com/fathulfahmy/face-recognition
- Owner: fathulfahmy
- License: mit
- Created: 2025-10-07T20:19:54.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-11-15T08:09:29.000Z (7 months ago)
- Last Synced: 2025-11-15T10:07:48.310Z (7 months ago)
- Topics: deepface, face-recognition, face-recognition-python, facial-recognition, machine-learning, opencv, opencv-python, python
- Language: Python
- Homepage:
- Size: 701 KB
- Stars: 2
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
Face Recognition
Face recognition using YOLO and face_recognition or DeepFace
Explore the docs »
Report Bug
·
Request Feature
Table of Contents
![Product screenshot][product-screenshot]
### Built With
- [YOLO](https://docs.ultralytics.com/models/yolo11/)
- [face_recognition](https://github.com/ageitgey/face_recognition)
- [DeepFace](https://github.com/serengil/deepface)
- [OpenCV](https://pypi.org/project/opencv-python/)
- [UV](https://docs.astral.sh/uv/)
## Getting Started
### Prerequisites
- Python >= 3.11
- UV
```sh
pip install uv
```
### Installation
1. Clone the repo
```sh
git clone https://github.com/fathulfahmy/face-recognition.git
```
2. Navigate to project directory
```sh
cd face-recognition
```
3. Install dependencies
```sh
uv sync
pre-commit install
```
## Usage
1. Insert faces in the `~/database/faces`
```
database
┗ faces
┣ Sebastian
┃ ┣ image1.jpg
┃ ┗ image2.jpg
┗ Mia
┣ image1.jpg
┗ image2.jpg
```
2. Run script
```sh
uv run app/main.py
```
3. Press `q` on GUI or `ctrl+c` on terminal to quit
## Roadmap
See the [open issues](https://github.com/fathulfahmy/face-recognition/issues) for a full list of proposed features (and known issues).
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the project
2. Create your feature branch (`git checkout -b feat/amazing-feature`)
3. Commit your changes (`git commit -m 'feat: add some amazing feature'`)
4. Push to the branch (`git push origin feat/amazing-feature`)
5. Open a Pull Request
### Top contributors
## License
Distributed under the MIT License. See `LICENSE` for more information.
## Contact
Your Name - [@fathulfahmy](https://linkedin.com/in/fathulfahmy) - fathulfahmy@protonmail.com
Project Link: [https://github.com/fathulfahmy/face-recognition](https://github.com/fathulfahmy/face-recognition)
## Acknowledgments
- [face_recognition](https://github.com/ageitgey/face_recognition/blob/master/examples/facerec_from_webcam.py)
- [DeepFace](https://github.com/serengil/deepface)
- [OpenCV](https://pypi.org/project/opencv-python/)
- [RasulAlakbarli/Face_Recognition_w_DeepFace](https://github.com/RasulAlakbarli/Face_Recognition_w_DeepFace/blob/master/main.py)
- [sykrwasd/face_recog_github](https://github.com/sykrwasd/face_recog_github/blob/master/app.ipynb)
[contributors-shield]: https://img.shields.io/github/contributors/fathulfahmy/face-recognition.svg?style=for-the-badge
[contributors-url]: https://github.com/fathulfahmy/face-recognition/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/fathulfahmy/face-recognition.svg?style=for-the-badge
[forks-url]: https://github.com/fathulfahmy/face-recognition/network/members
[stars-shield]: https://img.shields.io/github/stars/fathulfahmy/face-recognition.svg?style=for-the-badge
[stars-url]: https://github.com/fathulfahmy/face-recognition/stargazers
[issues-shield]: https://img.shields.io/github/issues/fathulfahmy/face-recognition.svg?style=for-the-badge
[issues-url]: https://github.com/fathulfahmy/face-recognition/issues
[license-shield]: https://img.shields.io/github/license/fathulfahmy/face-recognition.svg?style=for-the-badge
[license-url]: https://github.com/fathulfahmy/face-recognition/blob/master/LICENSE
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/fathulfahmy
[product-screenshot]: docs/screenshot.png