Skip to content

Latest commit

 

History

16 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Face Recognition System

A Python-based face recognition system using OpenCV (Haar Cascade) and the Face++ API.
Includes a compiled .exe for easy use without requiring Python installation.


Features

  • Detects faces using Haar Cascade classifier
  • Performs recognition with Face++ API
  • Works as both a Python script and a Windows EXE
  • Stores known faces in Faces.json locally
  • Configurable securely via config.json (created from example file)

📥 Installation (Source Code)

  1. Clone the repository:
    git clone https://github.com/evanpgibi/Face-Recognition.git
    cd Face-Recognition
  2. Install dependencies:
    pip install -r requirements.txt
    

⚙️ Configuration (Important!)

This project requires a config.json file with your Face++ API credentials. To keep your keys private, the real config.json is ignored by Git.

  1. Copy the example config file:
    cp config.example.json config.json

(On Windows: duplicate config.example.json and rename to config.json)

  1. Open config.json and add your Face++ keys:
    {
      "FACESET_TOKEN": "YOUR_FACESET_TOKEN",
      "API_KEY": "YOUR_API_KEY_HERE",
      "API_SECRET": "YOUR_API_SECRET_HERE"
    }
    
  2. Save the file. The program will now load your credentials without exposing them on GitHub.

▶️ Usage

  1. Run the exe (for non-programmers): Download the file from the Releases page and double-click Face_Recognition.exe to run.

  2. Run with Python:

    python Face_Recognition.py
    
    

About

A Python-based face recognition system using OpenCV (Haar Cascade) and the Face++ API. Includes a compiled .exe for easy use without requiring Python installation.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages