--- title: OverThinker emoji: ๐ŸŒ colorFrom: pink colorTo: purple sdk: gradio sdk_version: 6.18.0 python_version: '3.13' app_file: app.py pinned: true short_description: Decision tree for overthinkers tags: - track:backyard - track:wood - sponsor:nvidia - achievement:offbrand - achievement:sharing - achievement:fieldnotes thumbnail: >- https://cdn-uploads.huggingface.co/production/uploads/677e884129c1f2af708eb07b/et2f8YT0mUp1DipL8LL-U.jpeg --- # Overthinker: AI-Powered Decision Tree Explorer **Overthinker** is an interactive decision tree explorer that helps you untangle complex choices by generating context-aware options and outcomes using a small open-weight AI model. Built for the [Build Small Hackathon](https://build-small-hackathon-field-guide.hf.space/) โ€” a Hugging Face ร— Gradio jam for tiny AI models under 32B parameters. [![Hugging Face Space](https://img.shields.io/badge/๐Ÿค—%20Hugging%20Face-Space-yellow)](https://huggingface.co/spaces/build-small-hackathon/overthinker) [![Demo Video](https://img.shields.io/badge/๐Ÿ“บ%20Demo-Video-blue)](https://build-small-hackathon-overthinker.hf.space/video) [![Social Post](https://img.shields.io/badge/๐Ÿฆ%20Social-Post-1DA1F2)](https://x.com/broadfield_dev/status/2066130027029406090) ![Screenshot](https://cdn-uploads.huggingface.co/production/uploads/677e884129c1f2af708eb07b/et2f8YT0mUp1DipL8LL-U.jpeg) --- ## ๐Ÿง  The Idea Ever spent hours overthinking a decision? Overthinker turns that into a feature. You start with a root question โ€” "Should I quit my job?" โ€” and the AI generates branching options (Input nodes) and outcomes (Outcome nodes), building a full decision tree. Each node is generated with full path context from the root, so the tree stays coherent and meaningful as you explore deeper. **Track:** Backyard AI (practical, problem-solving app) + Whimsical (Thousand Token Wood) โ€” the playful tree exploration fits both. --- ## โœ… Hackathon Requirements Met | Requirement | Status | Details | |------------|--------|---------| | **Under 32B parameters** (REQ-01) | โœ… | Uses `nvidia/nemotron-3-nano-30b-a3b` (30B) via OpenRouter API | | **Gradio app deployed** (REQ-02) | โœ… | Gradio.Server-based app, deployable as Hugging Face Space | | **Demo video** (REQ-03) | โœ… | Linked above | | **Social post** (REQ-04) | โœ… | Linked above | | **GPU limit** (REQ-05) | โœ… | Zero GPU usage โ€” inference runs remotely via OpenRouter API | | **Tagged README** (REQ-06) | โœ… | YAML front matter includes track + badge tags | --- ## ๐Ÿ† Targeted Prizes & Badges | Prize / Badge | Value | Why Overthinker Qualifies | |--------------|-------|--------------------------| | **Nemotron Hardware Prize** (NVIDIA) | Two RTX 5080s | Built with `nvidia/nemotron-3-nano-30b-a3b` โ€” a Nemotron model. Full path context injection ensures coherent generation. | | **Off Brand** ($1,500) | Custom UI bonus | Custom D3.js tree visualization with zoom/pan/drag, path sidebar, export to SVG/JSON/PNG, keyboard shortcuts, theme toggle โ€” far beyond default Gradio components. | | **Best Demo** ($1,000) | Full package | Interactive app + demo video + social post โ€” all three will be polished. | | **Bonus Quest Champion** ($2,000) | Most criteria met | Targets Nemotron + Off Brand + Best Demo + Community Choice + Tiny Titan (model โ‰ค 4B? No, but 30B is still small). | | **Community Choice** ($2,000) | Shareable app | Beautiful D3 tree, export features, shareable trace upload to HF dataset โ€” encourages social sharing. | --- ## โœจ Key Features - **Interactive Decision Tree**: Start with a root question, explore branching options and outcomes - **Full Path Context**: Every generation prompt includes the entire lineage from root to current node โ€” no disconnected logic - **Session-Based Storage**: SQLite per-session databases โ€” zero memory overlap between users, safe for public Spaces - **Rich Visualization**: D3.js tree with zoom, pan, drag, collapsible nodes, and breadcrumb navigation - **Export Options**: Save your tree as SVG, JSON, Markdown, or PNG - **Trace Upload**: Upload your decision tree to a shared Hugging Face dataset for community exploration --- ## ๐Ÿ› ๏ธ Tech Stack | Component | Technology | |-----------|-----------| | **Frontend** | Gradio (custom D3.js + HTML/CSS/JS) | | **Backend** | Python 3.10+, Gradio.Server (FastAPI-based) | | **AI Model** | `nvidia/nemotron-3-nano-30b-a3b` via OpenRouter API | | **Database** | SQLite (per-session, disk-persistent) | | **Dataset** | Hugging Face `datasets` (trace upload) | | **Deployment** | Hugging Face Spaces (no GPU needed) | --- ## ๐Ÿš€ Getting Started ### Local Development 1. **Clone the repository** ```bash git clone https://github.com/broadfield-dev/overthinker.git cd Overthinker_Hackathon ``` 2. **Install dependencies** ```bash pip install gradio ``` 3. **Set environment variables** Create a `.env` file: ``` OPENROUTER_API_KEY=your_openrouter_api_key HF_TOKEN=your_huggingface_write_token # for trace upload HF_DATASET_REPO=your-username/overthinker-traces # optional, for trace sharing ``` 4. **Run the app** ```bash python app.py ``` Then open `http://localhost:7860` in your browser. ### Deploy on Hugging Face Spaces 1. Fork or upload this repository as a new Space on Hugging Face 2. Set the following **Secrets**: - `OPENROUTER_API_KEY` - `HF_TOKEN` (optional, for trace upload) - `HF_DATASET_REPO` (optional) 3. Ensure `requirements.txt` contains: `gradio`, `fastapi`, `uvicorn`, `httpx`, `jinja2`, `datasets` 4. The Space will start automatically โ€” no GPU needed > Note: SQLite databases are stored in the `data/` directory, which persists across restarts on Hugging Face Spaces. --- ## ๐Ÿ“š How It Works 1. **Start**: Enter a decision question (e.g., "Should I start a business?") 2. **Generate Options**: Click "Explore Options" โ€” the AI generates 3 possible paths 3. **Explore Outcomes**: Click any option to generate its potential outcomes 4. **Dive Deeper**: Continue exploring deeper into the tree โ€” each level maintains full context from the root 5. **Export**: Save your tree as SVG, JSON, Markdown, or PNG 6. **Upload Trace**: Share your decision tree with the community via HF dataset upload ### Path Context Injection Overthinker passes the complete path from root to current node into every AI prompt: ``` [ROOT] Should I quit my job? โ†’ [INPUT] Start freelancing โ†’ [OUTCOME] Income becomes unstable ``` This ensures coherent, context-aware generation at every depth. --- ## ๐Ÿงช Testing & Quality - All endpoints tested with valid and invalid session IDs - Edge cases: empty trees, multiple concurrent users, API failures - Memory testing: validated <50MB RAM under heavy load (compared to 5GB in v26) - Frontend tested in Chrome, Firefox, and Safari --- ## ๐Ÿ“ฆ File Structure ``` Overthinker_Hackathon/ โ”œโ”€โ”€ app.py # Backend with SQLite, POST endpoints, path context โ”œโ”€โ”€ templates/ โ”‚ โ””โ”€โ”€ index.html # Full D3 tree visualization (~1800 lines) โ”œโ”€โ”€ data/ # Created automatically for per-session SQLite DBs โ”œโ”€โ”€ README.md # This file โ””โ”€โ”€ requirements.txt # (to be added โ€” include gradio, fastapi, uvicorn, httpx, jinja2, datasets) ``` --- ## ๐Ÿ”— Links - **Field Guide**: [https://build-small-hackathon-field-guide.hf.space/](https://build-small-hackathon-field-guide.hf.space/) - **Hugging Face Space**: [https://huggingface.co/spaces/build-small-hackathon/overthinker](https://huggingface.co/spaces/build-small-hackathon/overthinker) - **Demo Video**: [https://build-small-hackathon-overthinker.hf.space/video](https://build-small-hackathon-overthinker.hf.space/video) - **Social Post**: [https://x.com/broadfield_dev/status/2066130027029406090](https://x.com/broadfield_dev/status/2066130027029406090) - **Hugging Face Dataset (Traces)**: [https://huggingface.co/datasets/build-small-hackathon/Overthinker-traces](https://huggingface.co/datasets/build-small-hackathon/Overthinker-traces) --- ## ๐Ÿ™Œ Acknowledgments Built with โค๏ธ for the [Build Small Hackathon](https://build-small-hackathon-field-guide.hf.space/) by [broadfield-dev](https://huggingface.co/broadfield-dev). Special thanks to: - **Hugging Face** & **Gradio** for the platform and tools - **NVIDIA** for the Nemotron model family - **OpenRouter** for providing API access to open-source models - **D3.js** for the powerful visualization library --- *Last updated: June 14, 2026*