a simple focus assist that actually works, both offline/ online to keep you focused. tl;dr: keeps you focused. runs every 5 mins. yells at you if you slack off.
Most of the dependencies are auto installed and u can skip to usage as is, still if any issues:
- install dependencies:
pip install .(oruv syncif you're cool) - install ollama: download here, run
ollama pull qwen3-vl:2b. - env vars: make a
.envfile if you want online mode:GROQ_API_KEY=your_key_here
- run it:
uv run main.py - follow instructions: tell it what you're doing.
- chill: it runs in background.
- offline: uses local ollama (qwen3-vl:2b). direct screen analysis. private. free.
- online: uses groq api (llama-4-scout-vision). multimodal analysis. super fast.