An adaptive desktop assistant that monitors posture and eyes to detect tiredness and enforce smart breaks during focused work or study sessions.
- Continuous monitoring via webcam (no identities stored)
- 4 indices: drowsiness, slouching, attention, yawn score
- Adaptive break timing: duration = scaler × weighted_score (learns over time)
- Input blocking overlay with countdown and early-exit if you become alert
Run the setup script:
chmod +x setup.sh
./setup.sh-
Install system dependencies (Linux):
sudo apt-get install python3-pip python3-tk
-
Install Python packages:
pip3 install -r requirements.txt
-
Verify installation:
python3 test_imports.py
python3 main.py- Start the app
- Capture a reference when you're alert and sitting properly
- The system monitors posture/eyes and computes 4 indices
- When the weighted score crosses threshold, a break overlay is triggered
- The scaler adapts per-task based on how quickly you recover during breaks
- Python 3.10+
- Webcam
- Linux/Windows/macOS
This project is licensed under the MIT License. See LICENSE for details.