FocusFlow — Fatigue-Aware Productivity Extension

Hackathon Project | Applied AI Theme

“Stay focused, work smarter, and listen to your body — FocusFlow adapts your web experience to your mental fatigue in real-time.”

FocusFlow is a lightweight browser extension designed for knowledge workers, students, and anyone who spends long hours in front of a screen. It uses real-time metrics from your webcam to detect fatigue, then adapts your browsing environment to help you stay productive, alert, and motivated — all without sending any personal video data to the cloud.

🚀 Unique Features!

1. Real-Time Fatigue Detection

Uses your webcam with Presage to detect blink rate and head motion.
Provides a live fatigue score to indicate when your focus is waning.
All processing is done locally, so no video or raw data is stored or sent.

2. Adaptive Web Experience

Dynamically adapts the page layout when fatigue is detected:
Increases text size
Reduces visual clutter
Helps your brain stay engaged without forcing long breaks.

3. Motivation Tips

Hit the Motivation button to get personalized tips instantly.
Access as many tips as you need, ranging from stretches and micro-breaks to positive self-talk.
Encourages healthy work habits without disrupting your flow.

4. Privacy-First Design

No data is sent to the cloud.
Only uses the webcam feed for local processing.
Safe for students, professionals, and anyone concerned about digital privacy.

5. Easy Controls & Accessibility

Toggle buttons for camera, adaptation, pause, and stop tracking.
Real-time fatigue score UI shows your current state at a glance.
Text-to-speech feature (“Star Audible”):
- Highlight a passage on a webpage and click play.
- The extension reads the passage aloud, highlighting each word as it is spoken.
- Users can pause at any time and resume from where they left off.
Combines productivity features with accessibility for reading, learning, and comprehension.

⚡ Installation & Setup (Developer Mode)

Clone this repository
Open the terminal and change your directory to backend using cd Hackhive-Hackathon26/backend
Once you are in 'backend/' install the dependencies using command pip install -r requirements.txt
Run the backend using python3 -m uvicorn app.main:app --reload
Once you run this, open a new terminal
Change your directory to frontend using cd Hackhive-Hackathon26/frontend
Now, run the commands npm install and then run npm run build
Open Chrome → chrome://extensions/
Enable Developer Mode
Click Load unpacked and select the dist folder from the frontend folder
Toggle camera access and explore the demo!