# Build Small Hackathon — Full Intelligence Dump
# Compiled 2026-06-08

## New Resources (not in original HACKATHON_README.md)

### gr.Server — True Custom Frontends (Off-Brand Badge Key)
- **Blog:** https://huggingface.co/blog/introducing-gradio-server
- **Docs:** https://www.gradio.app/main/guides/server-mode
- `gradio.Server` inherits from FastAPI — you can serve ANY HTML/CSS/JS frontend
  while keeping Gradio's queuing, concurrency, SSE streaming, and ZeroGPU support.
- Frontend connects via `@gradio/client` JS library using `client.predict()`
- This is the REAL Off-Brand path — not just custom CSS on gr.Blocks
- **Action:** Upgrade FocusFriend to gr.Server with a fully custom vanilla HTML/JS frontend

### ML Intern — Autonomous ML Agent
- **Repo:** https://github.com/huggingface/ml-intern
- Autonomous agent that researches, writes, and ships ML code using HF ecosystem
- Can be used WITH our projects for Sharing is Caring badge (agent traces)
- CLI tool: `ml-intern "build a TTS app"` — it researches and codes autonomously
- **Action:** Run ml-intern on our projects, share traces to Hub

### gr.Server Code Pattern (for FocusFriend upgrade)
```python
from gradio import Server
from fastapi.responses import HTMLResponse

app = Server()

@app.api(name="chat")
def chat_endpoint(message: str, history: list) -> dict:
    # LLM inference here
    return {"response": "...", "mood": "focus"}

@app.get("/", response_class=HTMLResponse)
async def homepage():
    with open("index.html") as f:
        return f.read()

app.launch()
```

Frontend (index.html) uses vanilla HTML/CSS/JS + @gradio/client library:
```javascript
import { Client } from "@gradio/client";
const client = await Client.connect(window.location.origin);
const result = await client.predict("/chat", { message, history });
```

---

## Competition Landscape — What's Already Submitted

### Spaces in the Org (213 total — 6 sampled)
| Space | Concept | Track |
|-------|---------|-------|
| mind-of-tashi | AI consciousness sim | Thousand Token Wood |
| vivamais | Health/wellness AI | Backyard AI |
| split-brain-copilot | Dual-perspective AI assistant | Thousand Token Wood |
| lolaby | Lullaby/audio generation | Backyard AI |
| NPCverse | AI NPC dialogue system | Thousand Token Wood |
| museum-of-unlived-lives | Generative art/storytelling | Thousand Token Wood |

### Models Published (32 total)
Notable fine-tunes (proving Well-Tuned badge is achievable):
- mind-of-tashi-micro-grpo (GRPO fine-tune)
- NeuroBait
- flux-costume-booth-lora (LoRA for Flux)
- tiny-quest-radio-aya-lora (LoRA fine-tune)
- pocket-tutor-minicpmv-socratic

### Datasets Published (22 total) — Sharing is Caring in action
- mind-of-tashi-runs (agent traces)
- 1000-Rooms-traces
- hackathon-advisor-codex-traces
- bedtime-story-machine-trace
- jawbreaker-scam-defense-data

### Blog Posts (12 Field Notes examples)
- ClinIQ: On-device pharmacist
- Thousand Token Wood sim v2/v3
- Building Pakistan Notice Helper
- Amazing Digital Dentures
- Room360: Video to 3D reconstruction
- Mythograph Atelier
- Her · हेर
- Job Searcher
- Persona Atlas

---

## Gap Analysis — What We Haven't Covered

### Badges NOT Yet Targeted
| Badge | Status | How to Get It |
|-------|--------|---------------|
| 🦙 Llama Champion | ❌ | Need to run model through llama.cpp runtime directly (not just llama-cpp-python) |
| 📡 Sharing is Caring | ❌ | Need to publish agent traces to HF Hub |
| 🎨 Off-Brand (true) | ⚠️ Partial | FocusFriend has custom CSS but should use gr.Server for full custom frontend |
| 🎯 Well-Tuned | ❌ | Need to actually fine-tune and publish a model |

### Sponsor Prizes NOT Targeted
| Sponsor | Prize | How to Target |
|---------|-------|---------------|
| NVIDIA | 2× RTX 5080 | Build with Nemotron models |
| Cohere | $5K cash | Use Cohere models (Command R, etc.) |
| Black Forest Labs | $3K cash | Use Flux image models |
| Modal | $20K credits | Deploy on Modal infrastructure |

### Special Awards NOT Targeted
| Award | Prize | How to Target |
|-------|-------|---------------|
| Tiny Titan | $1,000 | App using ≤4B param model |
| Bonus Quest Champion | $2,000 | Most badges on single submission |
| Best Demo | $1,500 | Best video + social post package |

---

## Third Project Ideas — Fill the Gaps

### Option A: "Tiny Bard" — Micro-Adventure Generator
- **Track:** Thousand Token Wood
- **Model:** Qwen 2.5 1.5B or Phi-4-mini (3.8B) — Tiny Titan eligible
- **Runtime:** llama.cpp (Llama Champion badge)
- **Concept:** Tiny LLM generates interactive text adventures. Each playthrough is 5 minutes.
  The AI creates rooms, NPCs, items, and branching narratives on the fly.
- **Frontend:** gr.Server with custom pixel-art/terminal UI
- **Badges:** 🦙 Llama Champion · 🏆 Tiny Titan · 🎨 Off-Brand · 🔌 Off the Grid · 📓 Field Notes
- **Prize targets:** Tiny Titan ($1K) · Thousand Token Wood ($4K-$1K) · Bonus Quest Champion potential

### Option B: "CritterCalm Mini" — Tiny Titan Edition
- **Track:** Backyard AI
- **Model:** Replace Dolphin-X1-8B with Qwen 2.5 1.5B — Tiny Titan eligible
- **Concept:** Slim version of CritterCalm that runs on ANY hardware. Just the calming templates + Kokoro TTS.
- **Badges:** 🏆 Tiny Titan · 🔌 Off the Grid
- **Effort:** Low (mostly repackaging existing work)

### Option C: "DreamSnap" — Surreal Pet Portrait Generator
- **Track:** Thousand Token Wood
- **Model:** Black Forest Labs Flux (small variant) + small LLM
- **Concept:** Describe your pet → generate surreal/delightful pet portraits. AI co-creates the art.
- **Badges:** 🎨 Off-Brand · 📓 Field Notes
- **Prize targets:** Black Forest Labs sponsor prize ($3K) · Thousand Token Wood

### Option D: "TraceShare" — Agent Trace Publisher
- **Concept:** Utility tool that helps ALL hackathon participants share agent traces easily
- **Use ML Intern** to generate traces, then publish to HF Hub
- **Badges:** 📡 Sharing is Caring (applied to multiple projects)
- **Effort:** Very low — just run ml-intern, capture traces, publish

---

## Recommended Action Plan (June 8-15)

### Priority 1: Upgrade Existing Projects
1. **FocusFriend → gr.Server** — Replace gr.Blocks with fully custom HTML/JS frontend
   - True Off-Brand badge qualification
   - Keep all existing Pip personality + mode logic
2. **CritterCalm → Add llama.cpp runtime** — Get Llama Champion badge
3. **Both → Share agent traces** — Run ml-intern, publish traces to Hub

### Priority 2: Quick Win — Tiny Titan
4. **Build "CritterCalm Mini"** — Slim version with ≤4B params
   - Same app structure, smaller model
   - Gets Tiny Titan award eligibility

### Priority 3: Third Project (if time permits)
5. **Build "Tiny Bard"** — Micro-adventure generator
   - Hits 5 badges at once (Llama Champion, Tiny Titan, Off-Brand, Off the Grid, Field Notes)
   - Strong Bonus Quest Champion candidate

---

## Updated Badge Strategy Per Project

### CritterCalm
| Badge | Status | Action |
|-------|--------|--------|
| 🔌 Off the Grid | ✅ Built local | Verify no API calls |
| 🎯 Well-Tuned | ⬜ | Fine-tune OmniVoice on pet-directed speech |
| 📓 Field Notes | ✅ Draft written | Polish and publish |
| 📡 Sharing is Caring | ⬜ | Run with ml-intern, publish traces |
| 🦙 Llama Champion | ⬜ | Add llama.cpp server mode option |

### FocusFriend
| Badge | Status | Action |
|-------|--------|--------|
| 🎨 Off-Brand | ⚠️ Partial | Upgrade to gr.Server custom frontend |
| 🔌 Off the Grid | ✅ Built local | Verify no API calls |
| 📓 Field Notes | ✅ Draft written | Polish and publish |
| 📡 Sharing is Caring | ⬜ | Run with ml-intern, publish traces |
| 🦙 Llama Champion | ⚠️ Partial | Already uses llama-cpp-python — add llama.cpp server flag |

### Tiny Bard (New)
| Badge | Status |
|-------|--------|
| 🦙 Llama Champion | ✅ llama.cpp native |
| 🏆 Tiny Titan | ✅ ≤4B model |
| 🎨 Off-Brand | ✅ gr.Server custom UI |
| 🔌 Off the Grid | ✅ Fully local |
| 📓 Field Notes | To write |

---

## Links Repository

### Hackathon Official
- Org: https://huggingface.co/build-small-hackathon
- Discord: https://discord.gg/YHECTft87Z
- README Space: https://huggingface.co/spaces/build-small-hackathon/README

### Tools & Kits
- ML Intern: https://github.com/huggingface/ml-intern
- Gradio Quickstart: https://www.gradio.app/guides/quickstart
- gr.Server Blog: https://huggingface.co/blog/introducing-gradio-server
- gr.Server Docs: https://www.gradio.app/main/guides/server-mode
- llama.cpp: https://github.com/ggml-org/llama.cpp

### Our Repos
- Monorepo: (this)
- CritterCalm: https://github.com/nbiish/crittercalm
- FocusFriend: https://github.com/nbiish/focusfriend

### Models We're Using
- OmniVoice: https://github.com/k2-fsa/OmniVoice
- Dolphin-X1-8B: https://huggingface.co/dphn/Dolphin-X1-8B-GGUF
- Gemma 4 12B: https://huggingface.co/unsloth/gemma-4-12b-it-GGUF
- Kokoro TTS: https://github.com/thewh1teagle/kokoro-onnx