quantumstack-labs/Smart-Attendance-System
A modern, high-performance Desktop Attendance System built with Python and CustomTkinter. Features a staff terminal mode, admin dashboard, and automated late-tracking logic
Smart Attendance System is a robust desktop application designed to replace paper logs and complex enterprise software. Built with Python and CustomTkinter, it offers a premium dark-mode interface that manages staff clock-ins, calculates late arrivals automatically, and keeps your data secure locally.
It features a Dual-Mode Architecture:
- Admin Dashboard: For owners to manage staff, view logs, and export data.
- Terminal Mode: A distraction-free, full-screen interface for staff to clock in using PINs.
📸 Interface Gallery
| 1. Secure Admin Entry | 2. Attendance Overview |
|---|---|
 |
 |
| 3. Staff Hub (Management) | 4. Advanced System Settings |
 |
 |
5. Shop Floor Terminal (Staff View)
✨ Key Features
🛡️ Admin & Management
- Dynamic Branding: Change your Shop Name and Admin PIN instantly in settings.
- Staff Hub: Add, edit, or remove employees with specific shift start times.
- Smart Logic: The system automatically flags entries as
LATEbased on a configurable grace period.
📊 Data & Security
- Zero-Setup Database: Uses SQLite. No server installation required.
- Excel Export: Download monthly attendance reports with one click.
- Privacy: All data is stored locally on your machine.
- Backups: Built-in tool to create manual database backups.
🚀 Getting Started
Option A: For Users (No Coding Required)
If you just want to run the app on your Windows PC:
- Go to the Releases Page.
- Download the latest
attendance_app.exefile. - Double-click to run!
Note: On the first run, Windows might ask for permission. Click "More Info" -> "Run Anyway".
Option B: For Developers (Source Code)
To run the source code or contribute:
-
Clone the repository
git clone [https://github.com/AA1-31-Murshid/Smart-Attendance-System.git](https://github.com/AA1-31-Murshid/Smart-Attendance-System.git) cd Smart-Attendance-System -
Install Dependencies
pip install -r requirements.txt
-
Run the App
python attendance_app.py
⚙️ Configuration
On the first launch, use the default credentials to unlock the system:
| Setting | Default Value | Action Required |
|---|---|---|
| Admin PIN | 0000 |
🔴 Change Immediately |
| Grace Period | 15 Minutes |
🟡 Adjust as needed |
⚠️ Important: Go to the Settings tab immediately to change the Admin PIN to something secure.
🛠️ Tech Stack
| Component | Technology | Description |
|---|---|---|
| Core | Python 3.10+ | Main programming language |
| UI Framework | CustomTkinter | Modern, high-DPI aware GUI |
| Database | SQLite3 | Local, serverless storage |
| Data Engine | Pandas | Excel export and data handling |
📂 Project Structure
📁 Smart-Attendance-System/
├── 📄 attendance_app.py # Main Application Source Code
├── 📄 requirements.txt # Python Dependencies
├── 📄 .gitignore # Git Configuration
├── 📄 LICENSE # MIT License
└── 📄 README.md # Project Documentation