CLARA (Cloud-based Attendance Recognition Automation): A sophisticated system leveraging facial recognition and cloud integration for automated, real-time attendance management.
CLARA (Cloud-based Attendance Recognition Automation) is an innovative attendance management system designed to streamline classroom attendance tracking using facial recognition.CLARA automates attendance marking from video input, integrating seamlessly with Google Sheets for real-time tracking and providing a modern, scalable solution for educational institutions.
Explore the Documentation | Website
CLARA revolutionizes attendance management by replacing manual roll calls with automated, video-based facial recognition. It empowers teachers, reduces administrative overhead, and ensures accurate, real-time attendance records. Key features include:
- 🎥 Video-Based Attendance: Upload or capture classroom videos for automated attendance marking.
- 🤖 Facial Recognition: Leverages
face_recognitionto identify students with high accuracy. - 🧾 Google Sheets Integration: Syncs attendance data to Google Sheets for easy access and reporting.
- 🖥️ Full-Stack Experience: Combines a sleek React frontend with a robust FastAPI backend.
Traditional attendance systems are time-consuming and error-prone. CLARA addresses these challenges by:
- Saving Time: Automates attendance in seconds, freeing teachers for instruction.
- Ensuring Accuracy: Uses advanced facial recognition to minimize errors.
- Enhancing Accessibility: Provides real-time attendance data via Google Sheets.
- Scaling Seamlessly: Handles multiple classes and large student cohorts with ease.
- Teacher Registration: Teachers sign up, auto create class-specific Google Sheets, and batchewise sheets.
- Student Enrollment: Students are registered with face images, stored securely in Google Drive.
- Video Upload: Teachers upload classroom videos, processed asynchronously for attendance.
- Face Recognition: CLARA scans videos, identifies students, and marks attendance in Google Sheets.
- Real-Time Tracking: Attendance data is updated instantly, accessible to teachers, admins and students (read-only).
- React.js: Dynamic UI with React Router for navigation.
- TailwindCSS: Responsive, modern styling.
- Webcam Integration: Real-time video capture and preview.
- FastAPI: High-performance REST APIs for video and data management.
- MongoDB: Stores teacher, student, and video metadata.
- Face Recognition: Powered by
face_recognition, OpenCV, and NumPy. - Google APIs: Drive for file storage, Sheets for attendance tracking.
- Async Processing:
asyncioandBackgroundTasksfor efficient video processing.
- Google Drive: Secure storage for student images and videos.
- Environment Management:
.envfor secure configuration. - Password Security: Bcrypt hashing for teacher credentials.
- Clone the Repository:
git clone <repository-url> cd clara
- Backend Setup:
- Install dependencies:
pip install -r backend/requirements.txt - Configure
.envwith MongoDB URI, Google Service Account, and folder IDs (see Documentation.md). - Run:
uvicorn backend.main:app --reload
- Install dependencies:
- Frontend Setup:
- Install dependencies:
cd frontend && npm install - Run:
npm start
- Install dependencies:
- Access CLARA:
- Backend:
http://localhost:8000 - Frontend:
http://localhost:3000
- Backend:
Detailed backend API documentation is available in Documentation.md, covering endpoints, data models, and setup instructions.
- Teachers: Save time and focus on teaching, not admin tasks.
- Students: Benefit from streamlined processes and accurate records.
- Institutions: Gain real-time insights into attendance trends.
- Scalability: Supports schools of all sizes, from single classrooms to large campuses.
- Real-time video streaming for instant attendance updates.
- Email alerts for absent students using
smtplib. - Advanced analytics for attendance patterns.
- Mobile app integration for on-the-go access.
🌟That's It!