🧠 Smart Attendance System

An AI-powered, touchless student attendance system that uses computer vision and facial recognition to automatically identify students, track their entry and exit, calculate attendance duration, and generate attendance reports.

🚧 Status: Functional Prototype v1.0.0

---

📌 Overview

The Smart Attendance System is designed to automate classroom attendance using facial recognition.

Instead of manually taking attendance, the system uses a camera to detect and recognize registered students. When a recognized student crosses the defined entry/exit zone, the system records their IN or OUT time and calculates the total time spent in the classroom.

The system also provides a web-based dashboard for managing students, viewing attendance history, generating reports, and exporting attendance data.

---

✨ Features

• 👤 Student registration with multiple facial samples
• 📷 Real-time face detection
• 🧠 Face recognition using facial embeddings
• ↔️ Direction-based IN/OUT detection
• ⏱️ Automatic attendance duration calculation
• 💾 SQLite database for persistent data storage
• 🌐 Flask-based web dashboard
• 👨‍🎓 Student management
• 📅 Date-wise attendance history
• 📊 Attendance reports and statistics
• 📄 CSV attendance export
• 📑 PDF attendance export
• 🔐 Foundation for administrator authentication
• 🤖 Designed for future ESP32 hardware integration

---

🛠️ Technology Stack

Technology	Purpose
Python	Core programming language
OpenCV	Computer vision and camera processing
YuNet	Face detection
SFace	Face recognition
Flask	Web dashboard and backend
SQLite	Database
HTML/CSS	Web interface
ReportLab	PDF report generation

---

🏗️ System Architecture

              📷 Camera
                  │
                  ▼
          ┌─────────────────┐
          │   OpenCV /      │
          │     YuNet       │
          │ Face Detection  │
          └────────┬────────┘
                   │
                   ▼
          ┌─────────────────┐
          │      SFace      │
          │ Face Recognition│
          └────────┬────────┘
                   │
                   ▼
          ┌─────────────────┐
          │ Attendance Logic│
          │   IN / OUT      │
          └────────┬────────┘
                   │
                   ▼
          ┌─────────────────┐
          │     SQLite      │
          │   attendance.db │
          └────────┬────────┘
                   │
                   ▼
          ┌─────────────────┐
          │ Flask Web       │
          │ Dashboard       │
          └────────┬────────┘
                   │
          ┌────────┼─────────┐
          ▼        ▼         ▼
      Students  Attendance  Reports
                             │
                       CSV / PDF