A modern, GUI-based face recognition access control system for secure user management and real-time access logging. Built with Python, OpenCV, face_recognition, and Tkinter.
- Face Recognition: Real-time face detection and recognition using webcam.
- Admin Panel: Secure login for administrators to manage users and view access logs.
- User Management: Add, edit, and delete users with face image capture.
- Access Logs: Automatic logging of all access attempts (granted/denied) with timestamps.
- Encodings Management: Regenerate face encodings as needed.
- Modern GUI: User-friendly interface built with Tkinter.
├── database_manager.py # Handles SQLite database operations
├── enhanced_encoder.py # Face encoding generation and management
├── run_face_recognition.py # Real-time face recognition logic
├── main_gui.py # Main GUI application (Tkinter)
├── requirements.txt # Python dependencies
├── EncodedImages.p # Pickled face encodings (auto-generated)
├── img/
│ └── Modes/ # User face images (auto-managed)
├── README.md # Project documentation
- Clone the repository
- Create a virtual environment (recommended):
python3 -m venv myenv source myenv/bin/activate - Install dependencies:
pip install -r requirements.txt
- Run the main GUI:
python main_gui.py
- Default Admin Login:
- Username:
admin - Password:
admin123
- Username:
- Add users via the Admin Panel (capture face images for recognition).
- Use the CHECK button to start real-time face recognition.
- Monitor access logs in the Admin Panel.
- Python 3.8+
- Webcam
- Linux, Windows, or macOS
See requirements.txt for all Python packages:
- opencv-python
- face-recognition
- face-recognition-models
- numpy
- pillow
- tk
- sqlite3 (usually included with Python)
- All user face images are stored in
img/Modes/. - Face encodings are stored in
EncodedImages.p(auto-generated). - The database is
face_recognition.db(auto-generated). - For best results, use clear, front-facing face images.
- If you got problem while installing face_recognition you have to make sure that cMake and dlib are correctly installed in your pc
🤝 Feel free to contribute or reach out:
kadanassim42@gmail.com