📌 Overview
Mark-Me is a smart attendance management system designed to simplify the process of marking and managing attendance digitally.
The project provides an efficient way to record, manage, and track attendance using a web-based interface powered by Python and FastAPI.
This system can be useful for:
🎓 Colleges and classrooms
🏫 Educational institutions
🏢 Small organizations
It helps automate attendance and reduces manual record keeping.
🎥 Project Preview
⚙️ Tech Stack
Backend: Python
Framework: FastAPI
Server: Uvicorn
Environment: Python Virtual Environment
Version Control: Git & GitHub
Mark-Me │ ├── main.py # Main application file ├── requirements.txt # Python dependencies ├── .env # Environment variables ├── README.md # Project documentation └── web uvicorn mainapp --host 0.0.0.0.txt
🚀 Features
✅ Digital attendance tracking ✅ Fast API backend ✅ Easy setup and deployment ✅ Lightweight and scalable ✅ Environment variable support
🛠 Installation 1️. Clone the Repository git clone https://github.com/amartya69/Mark-Me.git
2️. Navigate to the Project Folder
cd Mark-Me
3️. Create Virtual Environment
python -m venv venv
Windows
venv\Scripts\activate
Mac / Linux
source venv/bin/activate
- Install Dependencies pip install -r requirements.txt
Start the FastAPI server:
uvicorn main:app --host 0.0.0.0 --reload
Now open your browser:
API documentation available at:
🎯 Future Improvements
📊 Dashboard for attendance analytics
📅 Date-wise attendance tracking
👥 Student database integration
🔐 Authentication system
📱 Mobile responsive interface
✅ This README will make your project look:
Professional
Organized
Hackathon / portfolio ready
💡 One more small improvement for your repo (important):
Right now your repo has no description on the right side.
Add this in the About section:
Description
Smart attendance management system built using Python and FastAPI.
Topics
python fastapi attendance-system student-management backend-project