FocusGuard (Focus-OS)

FocusGuard is a local-first desktop productivity and focus management system designed to help users achieve deep focus through structured sessions, distraction blocking, and ML-powered insights.

🚀 Features

• Focus Session Timer: Structured work intervals (Pomodoro style).
• Process Blocking: Blocks distracting applications during active sessions.
• Behavior Tracking: Monitors active window usage and idle time.
• Gamification: Earn points and maintain streaks based on focus quality.
• Local Analytics: Detailed productivity charts and focus scores.
• ML-Driven Insights: Local models to predict optimal focus times.

🛠 Tech Stack

• Language: Python 3.11+
• UI Framework: PyQt5
• Database: SQLite3
• Analysis: scikit-learn, matplotlib, psutil
• Notifications: Plyer

📂 Project Structure

Focus-OS/
├── focusguard/
│   ├── core/       # Business logic & services
│   ├── db/         # Data persistence (Repository pattern)
│   └── ui/         # PyQt5 views and controllers
├── main.py         # Application entry point
├── config.py       # Centralized configuration
└── requirements.txt

⚙️ Setup & Installation

Prerequisites

• Python 3.11 or higher
• Virtual environment (recommended)

Installation Steps

1. Clone the repository:

   git clone <repository-url>
   cd Focus-Guide

2. Create and activate a virtual environment:

   python -m venv venv
   # Windows:
   venv\\Scripts\\activate
   # macOS/Linux:
   source venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run the application:

   python main.py