aminebrahmi / easy_facial_recognition

Easy faciale recognition app

Easy Facial Recognition

Recognition by minimum norm between vectors (128D dlib descriptor)

Prerequisites

Install requirements

Make sure to have the following libraries installed in your Python environment:

• opencv
• dlib
• numpy
• imutils
• pillow

Setup faces to recognize

Update the known_faces directory with images of people you want to detect and be sure to crop around the faces as the Zuckerberg example (if you don't, the program execution might raise an error).

Please only use .jpg or .png image format files in the known_faces folder.

For instance, you may have the following files:

/known_faces/Zuckerberg.png
/known_faces/YourPicture.jpg

Note that the recognition name displayed is taken from the file name (without extension) it matches in the known_faces folder.

Camera

You need a camera connected to your PC since the program will stream the image of camera on your screen and will recognize the face displayed should the face be part of the known_faces folder.

Run

easy_facial_recognition.py --i known_faces

Youtube Video explanation (French only)

Click on the image below:

Authors

• Anis Ayari - Lead Data Scientist

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Windows environment Notes

On Windows, you may have to additionnally install:

• opencv-python
• CMake
• Visual Studio and the extension for C++ so that dlib installation completes successfully