# face_recognition_project

## Face Recognition Project

Simple face recognition example and attendance utilities maintained by kcee tech.

Built and maintained by kcee tech.

## How to run

Prerequisites:

- Python 3.8 or newer
- pip
- A webcam (for live demos) or images for testing

Setup and run:

1. Create and activate a virtual environment:

```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1   # PowerShell
# or on cmd: .\.venv\Scripts\activate.bat
# or on mac/linux: source .venv/bin/activate
```

2. Install dependencies (common packages used by the examples):

```bash
pip install --upgrade pip
pip install face_recognition opencv-python numpy
```

3. Add known faces (if the project includes `add_faces.py`):

```bash
python add_faces.py
```

4. Start the demo application (if present):

```bash
python app.py
# then open http://localhost:5000 in your browser (typical Flask default)
```

5. Run included tests/examples:

```bash
python test.py
```

Notes:

- The `data/haarcascade_frontalface_default.xml` file is used for face detection; do not move it unless you update paths in the code.
- If an example needs a backend or database, set the required configuration in the script or environment variables as indicated in the source.

If you want, I can also inspect and generate a `requirements.txt` from the imports used in the project.