docs/DEMO_VIDEO.md

Demo Video Script

Hackathon demos are typically 2–3 minutes — this hits all the judging signals without padding.

---

1. Hook (0:00–0:15)

Open with the app already running. No explanation yet — just show the 3D avatar idle, the dark RPG theme, and say something like:

"This is Focus Buddy — a productivity companion that feels like an RPG, running entirely on a local 1B model."

---

2. The Core Loop (0:15–1:15)

This is the heart of the demo. Chat with the buddy and show the LLM controlling the UI via tool calls:

• Type: "Add a quest: finish my hackathon submission" → watch it appear in the todo list
• Type: "Let's start a 25-minute Pomodoro" → timer starts on its own (show the JS bridge doing its thing)
• Type: "Mark the submission quest done" → avatar plays animation, XP ticks up, coins increment
• Briefly show the Inventory panel sliding in over chat

---

3. Badges / Differentiators (1:15–1:45)

Quick verbal + visual callout for each badge:

• Off the Grid: show the model loading from HF Hub, no API key, no internet calls during inference
• Off-Brand: zoom in on the custom Three.js avatar + timer inside Gradio — "this is not a default Gradio component"
• Tiny Titan: mention openbmb/MiniCPM5-1B running

---

4. Free-Flow Mode (1:45–2:10)

Quick switch to Free Flow mode, type "Start free flow" — show the timer counting up instead of down. Shows the configurability / second mode.

---

5. Closer (2:10–2:30)

"Built in a weekend for the HF Build Small hackathon — Thousand Token Wood track. Local model, custom frontend, gamified focus loop. Try it on HF Spaces."

Show the Space URL on screen.

---

Tips

• Don't wait for LLM inference on camera — pre-warm the model and have the conversation pre-seeded. Cut between the typing and the response appearing.
• Zoom in on the XP bar when it increments — that's the "wow, it actually did something" moment.
• Screen record at 1080p, zoom your browser to ~110% so the UI reads clearly.
• Keep captions/music low-key — the tool calls doing real UI things is the interesting part, let that breathe.