{"id":24669276,"url":"https://github.com/dacosmicgiant/devbytes-focusflow","last_synced_at":"2026-05-09T13:03:40.912Z","repository":{"id":271858101,"uuid":"914789516","full_name":"Dacosmicgiant/DevBytes-FocusFlow","owner":"Dacosmicgiant","description":"FocusFlow is an intelligent study assistant that uses computer vision and AI to enhance your learning experience.","archived":false,"fork":false,"pushed_at":"2025-01-11T02:46:01.000Z","size":106,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T09:20:25.388Z","etag":null,"topics":["customtkinter","faster-whisper","mediapipe","opencv","pyautogui","speech-recognition"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dacosmicgiant.png","metadata":{"files":{"readme":"README.md","changelog":"history/AI_assistant-0.6.0.py","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-10T10:04:16.000Z","updated_at":"2025-01-13T14:31:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"eab6bd12-f82c-41ab-9840-1596ec286c9b","html_url":"https://github.com/Dacosmicgiant/DevBytes-FocusFlow","commit_stats":null,"previous_names":["dacosmicgiant/devbytes-istd-hackathon","dacosmicgiant/devbytes-focusflow"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dacosmicgiant%2FDevBytes-FocusFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dacosmicgiant%2FDevBytes-FocusFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dacosmicgiant%2FDevBytes-FocusFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dacosmicgiant%2FDevBytes-FocusFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dacosmicgiant","download_url":"https://codeload.github.com/Dacosmicgiant/DevBytes-FocusFlow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244805048,"owners_count":20513215,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["customtkinter","faster-whisper","mediapipe","opencv","pyautogui","speech-recognition"],"created_at":"2025-01-26T09:20:15.430Z","updated_at":"2026-05-09T13:03:35.885Z","avatar_url":"https://github.com/Dacosmicgiant.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FocusFlow: Your AI Study Companion 🎓\n\n[![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n\u003e Transform your study sessions with an AI companion that keeps you focused, maintains your well-being, and maximizes your learning potential.\n\n## 🌟 Features\n\n### 👁️ Intelligent Focus Monitoring\n\n- **Smart Pause/Play**: Automatically pauses your study content when you look away and resumes when you return\n- **Posture \u0026 Distance Detection**: Ensures you maintain a healthy distance from your screen\n- **Gesture Control**: Optional hand gesture controls for a touch-free experience\n\n### 😴 Drowsiness Detection\n\n- **Real-time Alertness Monitoring**: Tracks your blink rate and eye movement patterns\n- **Timely Break Reminders**: Suggests breaks when signs of fatigue are detected\n- **Head Position Analysis**: Monitors head tilting that may indicate drowsiness\n\n### 🎙️ AI Study Assistant\n\n- **Voice-Activated Note Taking**: Capture important points without breaking your flow\n\n### 🎯 Focus Enhancement\n\n- **Strict Mode**: Extra accountability for intensive study sessions\n- **Customizable Thresholds**: Adjust sensitivity to match your study style\n- **Progress Tracking**: Monitor your focus metrics over time\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n```bash\npip install -r requirements.txt\n```\n\nRequired packages:\n\n- OpenCV\n- MediaPipe\n- PyAutoGUI\n- SpeechRecognition\n- faster-whisper\n- customtkinter\n- CTkMessagebox\n\n### Quick Start\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/yourusername/focusflow.git\ncd focusflow\n```\n\n2. Install dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n3. Run FocusFlow:\n\n```bash\npython main.py\n```\n\n## 💡 Usage Tips\n\n### Optimal Setup\n\n- Ensure good lighting for accurate face detection\n- Position your camera at eye level\n- Maintain a comfortable sitting posture\n- Test different threshold settings to find your sweet spot\n\n### Control Modes\n\n1. **Face Detection Mode**\n\n   - Tracks your face position and eye movements\n   - Automatically manages content playback\n\n2. **Gesture Control Mode**\n   - Use simple hand gestures to control playback\n   - Perfect for hands-free operation\n\n### AI Assistant Commands\n\n- \"Take note [your note]\" - Captures a study note\n- \"Save notes\" - Saves all accumulated notes\n- \"Start video [URL]\" - Begins monitoring with video content\n\n## ⚙️ Customization\n\n### Adjustable Thresholds - Find your comfort.\n\n- Look Threshold: Sensitivity to head movement\n- Side Look Threshold: Tolerance for lateral head movement\n- Close Threshold: Screen distance warning trigger\n\n### Strict Mode Options\n\n- Enhanced focus monitoring\n- Stricter break enforcement\n- Detailed attention analytics\n\n## 🤝 Contributing\n\nWe welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n## 📝 License\n\nThis project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- MediaPipe team for their amazing computer vision tools\n- OpenCV community for image processing capabilities\n- Whisper by OpenAI for speech recognition\n- CustomTkinter for the modern UI components\n- ProgrammingHero YT for introducing us to mediapipe\n\n---\n\n\u003cp align=\"center\"\u003eBuilt with ❤️ for students, by students\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdacosmicgiant%2Fdevbytes-focusflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdacosmicgiant%2Fdevbytes-focusflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdacosmicgiant%2Fdevbytes-focusflow/lists"}