README.md

---
title: Face Recognition Attendance System
emoji: 👤
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
license: mit
---

# Face Recognition Attendance System

An advanced face recognition system for attendance management using DeepFace and OpenCV.

## Features

- **Student & Teacher Registration** with face capture
- **Face Recognition Login** 
- **Attendance Marking** with liveness detection
- **Real-time Analytics** and metrics dashboard
- **MongoDB Integration** for data storage

## Usage

1. Register as a student/teacher with face capture
2. Login using face recognition or credentials
3. Mark attendance with live face verification
4. View attendance records and analytics

## Technology Stack

- **Backend**: Flask, Python
- **Face Recognition**: DeepFace, OpenCV
- **Database**: MongoDB Atlas
- **Frontend**: HTML, CSS, JavaScript
- **Deployment**: Hugging Face Spaces (Docker)

## Environment Variables

Set these in your Hugging Face Space settings:
- `SECRET_KEY`: Your secret key
- `MONGO_URI`: MongoDB Atlas connection string
- `PORT`: 7860 (default)

## Local Development