Yug Patel

Posted on Oct 13

Unscatter AI: The Open-Source ADHD & Executive Dysfunction Copilot Built

#devchallenge #weekendchallenge #hf26challenge #opensource

Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle Submission 💸

This article is a submission for the Hacktoberfest Weekend Challenge: Build for a Friend.

💖 The Inspiration: Who I Built This For

My close friend Kavya is an exceptionally talented developer and university student who lives with adult ADHD and severe executive dysfunction.

Watching someone you care about get trapped in "ADHD Task Paralysis" (the freeze state) is heartbreaking:

The Paralysis Spiral: When coursework, project deadlines, and messages accumulate, her brain enters cognitive overload. Traditional productivity apps (Notion, Todoist, Asana) make it worse: they demand heavy taxonomy, tag-sorting, and show a giant wall of 30 intimidating tasks that induces panic.
Rejection Sensitive Dysphoria (RSD): Short, unpunctuated messages like "We need to talk tomorrow morning" or "Check my comments ASAP" cause acute chest-tightening anxiety and dread, making her freeze before responding.
The Quiet Room Struggle: Working in isolation is mentally draining. ADHD psychology shows that "Body Doubling" (having a supportive, non-judgmental presence in the room) helps overcome initiation friction.

I decided to build Unscatter AI as an open-source gift for Kavya—and for anyone fighting executive paralysis.

🚀 What I Built

Unscatter AI is a local-first, distraction-free companion engineered to lower the activation energy of daily life:

1. 🌪️ Brain Dump Unscrambler ("Unfreeze Inertia")

Instead of sorting tasks into folders, users speak or type their raw stream-of-consciousness chaos into the box (e.g. "I'm sitting on the floor panicking, I have 8 assignments due, my inbox is full of scary emails, my desk is messy, I haven't eaten").

The AI decomposes the panic into bite-sized 2-to-5 minute atomic micro-steps.
It highlights a "🌱 Micro-Launch Step" requiring near-zero willpower (e.g. "Open editor tab and drink a sip of water") to get the dopamine flywheel turning.

2. 🥄 Spoon Theory Energy Calibrator

Calibrates tasks against current mental energy (from 1 Spoon = burnout survival, up to 5 Spoons = hyperfocus surge), eliminating guilt on low-energy days.

3. 🛡️ RSD Shield & Communication Calmer

Incoming Shield: Deconstructs blunt emails from bosses/professors into objective facts, performs a psychological reality check on why the sender isn't angry, and generates a calm 1-click reply.
Outgoing Softener: Transforms anxious, over-apologetic drafts ("I'm so so sorry for existing and being late...") into grounded, professional communication ("Thank you for your patience...").

4. ☕ Virtual Body Doubler with Web Audio Synthesizer

A quiet co-working companion providing parallel presence with timer check-ins.
Built-in Web Audio API ambient sound generator that synthesizes calming brown noise and rain frequencies directly in pure browser code without loading external MP3 files.
Visual breathing ring to down-regulate sympathetic nervous system arousal.

5. 🏆 Friend's Compassion Vault (Evidence Locker)

ADHD brains often experience "emotional amnesia"—when frozen, they forget every prior achievement. This vault stores concrete evidence of competence and encouraging notes from friends.

🧠 Why Open-Source AI was Integral to This Project

The Hacktoberfest challenge specifically calls out the necessity of an open-source AI approach. For Unscatter AI, open-weight models were essential for three non-negotiable reasons:

1. Radical Privacy for Vulnerable Mental Health Data

A brain dump often contains intensely private confessions: emotional distress, struggles with medication, workplace anxiety, and personal diaries. Routing these thoughts through commercial cloud LLM APIs means handing sensitive psychological telemetry to advertising giants. Running open-weight models (via Ollama llama3.2 or quantized edge models) ensures that every thought stays strictly on local silicon.

2. Zero-Cost Accessibility for Neurodivergent People

ADHD and executive dysfunction disproportionately cause financial precarity (the "ADHD tax"). Tools designed to help people function should never be locked behind \$20/month SaaS paywalls. Open-weight models ensure that anyone with a laptop can run their personal companion for free forever.

3. Empathy Tuning & Tone Freedom

Proprietary cloud models often respond with sterile, patronizing corporate cheerleading. With open weights, prompts and models are shaped to act like a gentle, realistic best friend who validates struggles rather than lecturing.

🛠️ Tech Stack & Architecture

   ┌─────────────────────────────────────────────────────────┐
   │             Responsive Web Interface                    │
   │  (Tailwind CSS, Phosphor Icons, Web Audio Synthesizer)  │
   └────────────────────────────┬────────────────────────────┘
                                │ HTTP / JSON API
   ┌────────────────────────────▼────────────────────────────┐
   │                     FastAPI Backend                     │
   │                  (Python 3.12, Uvicorn)                 │
   └─────────────┬─────────────────────────────┬─────────────┘
                 │                             │
   ┌─────────────▼─────────────┐ ┌─────────────▼─────────────┐
   │   Open-Source AI Engine   │ │     Local SQLite DB       │
   │ ├─ Ollama (Local Llama 3.2│ │     (unscatter.db)        │
   │ └─ Offline Edge Heuristics│ └───────────────────────────┘
   └───────────────────────────┘

Backend: Python 3.12, FastAPI, Uvicorn, Pydantic, HTTPX
AI Core: Ollama local inference (llama3.2, mistral, gemma2) with fallback to Edge Neurodivergent Heuristics
Frontend: Vanilla HTML5/JS, Tailwind CSS, Web Audio API, Web Speech Recognition API
Persistence: Local SQLite (unscatter.db)

💻 Source Code & Quickstart

The repository is open source and ready to run locally:

# 1. Clone the repository
git clone https://github.com/your-username/unscatter-ai.git
cd unscatter-ai

# 2. Install dependencies & run (or double-click run.bat on Windows)
cd backend
python -m pip install -r requirements.txt
python main.py

Then visit http://localhost:8001 in your browser.

🌟 Reflections & Next Steps

Building this project taught me that the best applications aren't built for abstract demographics—they are built for specific people you care about. Seeing my friend Kavya take a deep breath, break through a terrifying backlog in 10 minutes, and smile was worth every line of code.

Future plans include:

Expanding the offline Web Audio ambient engine with binaural beats
Native desktop tray notifications for body-double check-ins
Multi-device local P2P sync via WebRTC

DEV Community