How jeet2005/eyex works
Eye-X is a smart-attendance and classroom-behavior analytics system. Camera clients stream through WebRTC, while the server coordinates signaling, recognition, attendance records, and analytics; administrators use a dashboard to monitor results and export reports. The source index and excerpts establish the server’s service dependencies and attendance/database actions. Some client and route details are unsampled, so those relationships are shown only where the README documents them.
Main entry points: app.py FastAPI application · config.py Runtime configuration · face_recognizer.py Face recognition · mongodb.py Attendance records
Components 16
Camera and dashboard clients
- Edge cameras
- Admin dashboard
static/js/dashboard.js - Camera client
static/js/webrtc-client.js - Stream viewer
static/js/webrtc-viewer.js
Application and real-time services
- FastAPI application
app.py - WebRTC signaling
services/signaling.py - Runtime configuration
config.py - Attendance announcements
services/audio_service.py
Recognition and behavior analysis
- Face detection
services/face_detector.py - Face recognition
services/face_recognizer.py - Behavior analysis
services/behavior_detector.py
Attendance and reporting
- Attendance records
database/mongodb.py - Analytics and snapshots
database/mongodb.py - Report generation
services/export.py
Other components
- MongoDB
- Report consumers
Connections 19
- Edge cameras → Camera client: captures for
README.md - Camera client → WebRTC signaling: exchanges signaling
README.md - Stream viewer → WebRTC signaling: exchanges signaling
README.md - Admin dashboard → Stream viewer: renders streams
README.md - FastAPI application → WebRTC signaling: routes signaling
app.py - FastAPI application → Face detection: uses detection
app.py - FastAPI application → Face recognition: uses recognition
app.py - FastAPI application → Behavior analysis: uses analysis
app.py - FastAPI application → Attendance records: checks and marks
app.py - FastAPI application → Report generation: generates reports
app.py - FastAPI application → Attendance announcements: uses announcements
app.py - Face recognition → Attendance records: loads embeddings
services/face_recognizer.py - Attendance records → MongoDB: reads and writes
- FastAPI application → Analytics and snapshots: requests summaries
app.py - Analytics and snapshots → MongoDB: reads and writes
- Report generation → Report consumers: produces files
README.md - Runtime configuration → Face detection: configures thresholds
services/face_detector.py - Runtime configuration → Face recognition: configures threshold
services/face_recognizer.py - Runtime configuration → Behavior analysis: sets model path
services/behavior_detector.py