Face Recognition Attendance System

Author: Anup Chapagain
Email: uanup.mpersonal.a@gmail.com

---

📖 Project Overview

A Python-based face recognition attendance system that:

1. Registers a new face once
2. Recognizes the person automatically in subsequent sessions
3. Marks attendance with timestamp in a CSV file

This system can be applied in:

• 🎓 Classrooms – Automated student attendance
• 🏢 Offices – Employee check-in
• 🎟 Events – Quick guest registration

---

✨ Features

• Face Registration: Capture and store unique faces
• Automatic Recognition: Identify returning faces in real-time
• Attendance Logging: Generate CSV logs with name and timestamp
• Lightweight & Scalable: Can run on a standard PC or Raspberry Pi

---

🛠 Tech Stack

• Python 3
• OpenCV – Real-time video capture & detection
• face_recognition library (built on dlib)
• NumPy & Pandas – CSV attendance handling

---

📂 Project Structure

face-attendance-system/
 ├─ src/
 │   └─ attendance.py         # Main script
 ├─ database/
 │   ├─ faces/                # Registered face images
 │   └─ attendance.csv        # Attendance log
 ├─ sample_output/
 │   ├─ demo_recognition.png
 │   └─ attendance_example.png
 ├─ requirements.txt
 └─ README.md

---

🚀 Quick Start

1. Clone the repository

git clone https://github.com/anupanonymous/face-attendance-system.git
cd face-attendance-system/src

2. Install dependencies

pip install -r requirements.txt

3. Register a new face and mark attendance

python attendance.py

---

💡 Future Scope

• Integrate with Raspberry Pi IoT door lock
• Add cloud database for attendance tracking
• Build a GUI dashboard for admin/teacher use

---

👤 About Me

Anup Chapagain
AI & IoT Enthusiast | Film making Aspirant