docs/demo-script.md

# Demo video kit — shot list & script (target: 100–120 seconds)

> Field-guide intel: "Storytelling counts as much as the build — no humility,
> sell it." Video may be uploaded directly to the Space as a file.
> Record at 1080p+; phone-filming-a-screen is fine for the human shots.

## Ready-made assets

| Asset | Where |
|---|---|
| Live Space | https://build-small-hackathon-mystery-mail-guardian.hf.space |
| Language deep-links | append `?lang=hi` / `?lang=es` / `?lang=ja` |
| Local mock with auto-demo | `$env:GUARDIAN_MOCK="1"; .venv\Scripts\python.exe app.py` then `/?lang=ja&autorun=1` (b-roll; never burns GPU) |
| 4-language speech WAVs | `modal_artifacts/speech_{en,hi,es,ja}.wav` (48 kHz VoxCPM2) |
| UI stills (b-roll) | `docs/ui/*.png` |
| Synthetic letters to print | run `.venv\Scripts\python.exe scripts\make_samples.py`, print `assets/samples/{bill,scam}.png` |

## Shot list (the five beats the judges were told to look for)

**1. The person (0:00–0:20) — beat (a)**
Real person, real kitchen table, real mail in hand. One line of setup, in
their own words: what confusing or scary mail looks like to them.
> "This is for [name]. Letters like these are how people like her get robbed."

**2. The scam catches fire (0:20–0:50) — beat (b)**
Phone camera on the printed gift-card scam letter → "Read my letter" → the
envelope-flap loader → three paper sheets land with the red warning stamp.
Read two of the reasons out loud. Then tap 🔊 — let VoxCPM2 speak a sentence.
> "Twenty seconds, fully offline: warning stamp, the exact tricks named, and
> the scammer's phone number is nowhere on this screen."

**3. The safety layer story (0:50–1:10) — beat (c)**
One sentence over B-roll (BUILD_LOG on screen or the warning card):
> "In live testing the model once suggested *contacting the tax bureau and
> paying soon*. Our safety layer is code, not a prompt — it threw that advice
> away, kept the warning, and always appends: verify through a number YOU
> already trust."

**4. Built for elders, down to the font (1:10–1:30) — beats (d) + easter egg**
Quick cuts: 56px language buttons (`English | हिन्दी | Español | 日本語`) →
tap हिन्दी, whole UI flips → tap 日本語 and the **Gen X Soft Club easter egg**
melts the screen into pastel Y2K (still WCAG-AA, say it!).
> "The body font is Atkinson Hyperlegible — designed by the Braille Institute
> for low-vision readers. An elder-readability font in an elder-readability
> app. And yes — Japanese has an easter egg."

**5. The close (1:30–1:50) — beat (e)**
Footer on screen (model colophon visible):
> "Every model is OpenBMB — 3.3 billion parameters total, smaller than the cap
> by ten times, 100% local. The letter never leaves the device. All our GPU
> testing ran on Modal — including the eval that caught a privacy bug before
> any human did. Mystery-Mail Guardian: small models, watched closely,
> guarding the people we love."

## Recording gotchas

- ZeroGPU cold start: do one throwaway analysis before recording shot 2 so
  the real take runs warm (~20–40s).
- The easter egg toggles on selecting 日本語 — switch back to English first so
  the flip is visible on camera.
- Don't show the `?autorun` URL on screen (mock-only tooling).
- The disclaimer line must be visible in at least one shot (it always is —
  footer). Keep it: judges read it as a feature, because it is one.