README.md

Student Attendance Management

A smooth, production-ready tool to manage and analyze attendance using NumPy, Pandas, and SQLite. It runs in a Jupyter Notebook and as a Hugging Face Space (Gradio app).

Features

• CSV ingest to SQLite (schema: StudentID, StudentName, Subject, Date (YYYY-MM-DD), Status (Present/Absent))
• NumPy-based per-student attendance percentage
• Pandas-based per-subject summaries and low-attendance queries
• Date, subject, and student filters
• CSV exports from the Gradio UI

Quick Start (Jupyter)

1. Open Attendance_Tool_Notebook.ipynb
2. Run cells top to bottom
3. Replace the demo CSV with your own if needed

Quick Start (Hugging Face Spaces)

1. Create a new Gradio Space
2. Upload the files from this folder:
   • app.py
   • attendance_core.py
   • requirements.txt
   • (optional) demo_attendance.csv for testing
3. The app will launch automatically.

CSV Format

StudentID,StudentName,Subject,Date,Status
S001,Alice,Math,2025-07-01,Present
S001,Alice,Math,2025-07-02,Absent
...

Status accepts common variants (P/Present/1/Yes/Y -> Present; anything else -> Absent).

Environment

• Python 3.10+
• Dependencies in requirements.txt