Face Recognition Web App

A comprehensive face recognition system that supports multi-person detection, average embeddings from multiple images, and bulk processing of face databases.

Quick Start

# Setup and start
make setup
make up

Visit: http://localhost:5000

Key Features

• 🔍 Multi-face detection with bounding boxes and labels
• 👥 Multiple images per person with automatic average embedding calculation
• 📦 Bulk processing of folder structures containing people's images
• 📊 Comprehensive logging and data examination tools

Essential Commands

# Development
make up          # Start app (shows logs)
make dev         # Development mode (auto-reload)
make down        # Stop app
make status      # Check if running

# Database
make db-stats    # Show database info
make db-backup   # Backup database
make db-clean    # Clean database

# Testing
make test-bulk   # Test bulk processing
make test-multi  # Test multi-face recognition

# Monitoring
make logs        # View logs
make health      # Health check

Usage Examples

Bulk Process Folder Structure

# Organize like this:
# people_db/
# ├── John_Doe/
# │   ├── john1.jpg
# │   └── john2.jpg
# └── Jane_Smith/
#     └── jane1.jpg

curl -X POST -d 'folder_path=/path/to/people_db' \
     http://localhost:5000/api/bulk_process_local

Add Single Person

curl -X POST -F "image=@person.jpg" -F "name=John Doe" \
     http://localhost:5000/api/add_person

Recognize Faces

curl -X POST -F "image=@group_photo.jpg" -F "threshold=0.6" \
     http://localhost:5000/api/recognize_visual

File Structure

webapp/
├── app.py                     # Main application
├── Makefile                   # All commands
├── requirements.txt           # Dependencies
├── face_database/embeddings/  # Face data
├── logs/                      # Application logs
└── uploads/                   # Temporary files

Run make help for all available commands.