Skip to content

Latest commit

 

History

History
85 lines (57 loc) · 2.33 KB

README.md

File metadata and controls

85 lines (57 loc) · 2.33 KB
Raw

Logo

FaceDetec' is a cutting-edge project aimed at precise face similarity detection and analysis.

⚠ Curently only support linux

🔍 Features

  • Command Line Interface: Built with colorama for better interaction.
  • Deeface Library Integration: Harnesses advanced facial recognition capabilities.
  • MediaPipe Library Integration: Integrating advanced facial contour detection capabilities.
  • Facial Feature Extraction: Identifies eyes 👀, nose 👃, and mouth for manual review.
  • HTML Report Generation: Automatically generates detailed reports for analyzed faces.

🚀 Status

FaceDetec' is currently usable for production in a CLI-only mode. Stay tuned for upcoming releases to leverage the full functionality of FaceDetec. Contributions and feedback are welcome as we work towards a GUI mode.

📝 Usage

FaceDetec' Project Setup Guide

This guide will help you set up and run FaceDetec' on your machine.

Prerequisites

  • Python installed on your machine (version 3.9 or higher is recommended).
  • pip (Python package installer) installed.

Step 1: Clone the Project Repository

  1. Open a terminal or command prompt.

  2. Navigate to the directory where you want to clone the project.

  3. Run the following command to clone the repository:

    git clone https://github.com/ahnaf505/FaceDetec-.git

  4. Navigate into the FaceDetec- directory:

     cd FaceDetec-

Step 2: Install libgl1-mesa-glx (Really important DO NO SKIP)

sudo apt-get update
sudo apt install -y libgl1-mesa-glx

Step 3: Install the Requirements

  1. Ensure you are in the project directory.

  2. Run the following command to install the required packages:

    pip install -r requirements.txt

Step 4: Run the app.py

  1. Run the main Python file 'app.py':

    python app.py

  2. Press 'enter' and input the path for the first and second image.

  3. Wait to make sure there's no error until the report is generated

  4. Congrats! you have made a face comparison report with FaceDetec'

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

© Ahnaf | ahnaf505/FaceDetec-