ClassifyAI is an AI-powered classroom companion that automates attendance, tracks student engagement, and makes learning fun with a real-time emotion game — all through face and voice recognition.
- What is ClassifyAI?
- Features
- System Architecture
- Project Flowchart
- Prerequisites
- Installation
- Usage Guide
- API Reference
- Database Schema
- Frontend Components
- Contributing
- Production Deployment
- Roadmap
- License
- Closing Note
ClassifyAI is your all-in-one platform for smarter classrooms:
- 🎓 Automated attendance via face and voice recognition
- 📊 Real-time mood analytics to track student engagement
- 🎮 Interactive emotion game to boost emotional intelligence and participation
No manual roll calls, no guesswork — just smarter, more connected classrooms.
- Upload Excel sheets with student data
- Store images, interests, and skills
- Edit and manage profiles from dashboard
- Face recognition-based attendance
- Voice confirmation for accuracy
- Full attendance logs with timestamps
- Detect emotions live during class
- Track engagement trends over time
- Generate actionable insights
- AI challenges students to mimic emotions
- Instant scoring and leaderboard
- Fun way to build emotional intelligence
┌──────────────┐ ┌───────────────┐ ┌───────────────┐
│ Frontend │◄──►│ API │◄──►│ Database │
│ (React + MUI)│ │ (FastAPI, Python) │ │ (PostgreSQL + Supabase) │
└──────────────┘ └───────────────┘ └───────────────┘
- Frontend: React + Material-UI
- Backend: FastAPI (Python)
- Database: PostgreSQL / Supabase for scalability
1. Upload Student Data ─► Database stores profiles + face encodings
2. Start Attendance Session
├─► Webcam feed ─► Face Recognition ─► Attendance Marked
└─► Microphone ─► Voice Recognition ─► Cross-verification
3. Mood Analytics ─► Real-time emotion detection ─► Engagement Reports
4. Emotion Game
├─► AI Prompts Emotion ─► Student Mimics ─► Scoring + Leaderboard
- Docker & Docker Compose
- Node.js (v14+)
- Python (v3.8+)
- PostgreSQL (v13+)
git clone <repository-url>
cd classifyai
cp .env.example .env
docker-compose up -dOpen your browser:
- App:
http://localhost:3000 - API Docs:
http://localhost:8000/docs
cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python app.pycd frontend
npm install
npm startcreatedb classifyai
psql -d classifyai -f database/schema.sqlUpload Excel file with:
| Field | Description |
|---|---|
| name | Student full name |
| class | Class name |
| roll | Roll number |
| subjects | Comma-separated |
| interests | Comma-separated |
| about | Bio |
| skills | Comma-separated |
| image_path | Image file path or URL |
- Start session
- Students look at camera and say "I am present"
- System logs attendance automatically!
- View mood trends in real time
- Generate reports for sessions or classes
- Start game session
- Mimic prompted emotions
- Score points and view leaderboard!
Docs: http://localhost:8000/docs
| Endpoint | Description |
|---|---|
POST /api/students/upload |
Upload student data |
POST /api/attendance/session/start |
Start attendance session |
POST /api/attendance/recognize |
Recognize and log attendance |
GET /api/analytics/session/{id} |
View session analytics |
POST /api/game/start |
Start game session |
POST /api/game/submit |
Submit emotion attempt |
GET /api/game/leaderboard |
View game leaderboard |
| Table Name | Purpose |
|---|---|
students |
Student profiles, face encodings |
attendance_sessions |
Attendance session metadata |
attendance_records |
Logs of attendance events |
game_sessions |
Emotion game sessions |
game_scores |
Game scores |
session_analytics |
Mood and engagement trends |
| Component | Purpose |
|---|---|
| HomePage | Welcome page |
| StudentManagement | Upload & manage student profiles |
| AttendancePage | Live face/voice attendance |
| AnalyticsPage | Mood and engagement trends |
| GamePage | Play emotion mimic game |
| Dashboard | Layout & navigation hub |
We welcome contributions!
- Fork the repo
- Create your branch (
git checkout -b feature/feature-name) - Commit changes
- Push to your branch
- Open a Pull Request
Your ideas help shape the future of ClassifyAI!
- Use Supabase for managed PostgreSQL & cloud storage
- Deploy Docker containers to:
- AWS ECS / EKS
- DigitalOcean App Platform
- Render / Vercel (frontend)
- Set up CI/CD pipeline (GitHub Actions / GitLab CI)
- Add SSL and connect to your custom domain (e.g.,
app.classifyai.com) - Implement monitoring (Grafana / Prometheus)
- Face & voice-based attendance
- Real-time mood tracking
- Emotion game with leaderboard
- Basic reporting
- Student insights dashboard
- Exportable student reports
- Multi-class, multi-teacher management
- Parent/guardian dashboard
- Mood heatmaps & engagement exports
- AI engagement suggestions
- Timed challenges
- Multiplayer game mode
- Rewards, badges, certificates
- Sentence sentiment analysis
- Track speech improvements over time
- Predictive attendance trends
- Passive auto-attendance from class feed
- LMS integrations (Google Classroom, Moodle)
- White-label / custom branding
- GDPR / FERPA compliance mode
ClassifyAI is licensed under the MIT License.
Free to use, share, and build upon.
Built with ❤️ by Aniket (Mr. Ani) — empowering educators with smart, engaging, AI-driven classroom solutions.
ClassifyAI isn’t just about tracking attendance.
It’s about understanding your classroom. Boosting engagement. Making learning fun.
🚀 Let’s build the future of education, together.
Ready to launch. 🚀