docs/demo-script.md

Demo video script — Orion's Cottage (80–85s cut)

Record on: https://huggingface.co/spaces/donniefi/orionscottage

Pre-flight

• Full-screen, no devtools. Modal GPU polish ON.
• Cottage (Rural) · target Orion (or Cassiopeia if score looks better).
• Orion = the AI cottage journal (Ask Orion, field notes) — not just the constellation. Say that once in the hook.

Target: 80–85 seconds. Get to Plan observation fast; let the UI carry detail.

---

Tight shot list (primary)

0:00–0:12 — Hook

Screen: Planner · title bar · Cottage (Rural).

Say:

Hi everyone — I'm building for rural Nova Scotia cottage skies. Too many apps, cold nights, and I just want one simple field journal.

Orion's Cottage uses real astronomy code for the best nights to head outside, then three tiny models turn the same facts into family English, Québec French, or a technical brief. Small models — fast, cheap, runnable when the internet is spotty.

---

0:12–0:22 — Target + Ask Orion (quick)

Screen: Target Orion · optional: type in Ask Orion Best weekend in July for Cassiopeia? · show date/target fill · or skip Ask and just pick Orion.

Say:

Pick a constellation from the list — or ask Orion in plain English for a date and target. Hit Plan observation, and every journal pulls from the same Skyfield facts.

(If you show Ask Orion live, add one line: "Deterministic — no hallucinated rise times.")

---

0:22–0:28 — Sky tease (one breath)

Screen: Scroll to Sky view — zenith (no orange yet).

Say:

This chart isn't an LLM guess — Skyfield for what's overhead, starplot drawing it. Plan once and your target lights up in orange.

---

0:28–0:45 — Plan + three models

Screen: Plan observation · talk over spinners if Modal is cold · click MiniCPM → Aya (pause on French) → Nemotron · point at ✓ LLM narrative · modal.

Say:

One click. Three small specialists on the exact same facts.

MiniCPM — warm family summary.

Aya — full guide in Québec French. We're in Canada.

Nemotron — tight observatory brief: RA, Dec, seeing, eyepiece.

Python owns every score and rise time. The models only polish the journal.

---

0:45–0:52 — Modal

Screen: Modal toggle ON · status badges visible.

Say:

At home these three queue on my 3060. On Modal they run in parallel across GPUs — one Plan fills every tab while you watch. That's the runtime win.

---

0:52–0:58 — Sky pay-off

Screen: Sky view — zenith · Orion in orange.

Say:

There — Orion highlighted. Same target you picked upstairs.

---

0:58–1:05 — Off Grid

Screen: Toggle Off Grid · weather chip · Modal greys out.

Say:

Off Grid skips weather APIs — ephemeris still runs. Perfect when cottage signal drops.

---

1:05–1:15 — Close

Screen: Brand bar.

Say:

Orion's Cottage — Build Small Hackathon. Skyfield does the real work; MiniCPM, Aya, and Nemotron under four billion each. Clear skies. Link in the description. #BuildSmallHackathon

---

Cut first (if still long)

1. Ask Orion beat (mention in close / description only)
2. Off Grid (YouTube description only)
3. Red-light — cut from primary (bonus B-roll only)
4. Targets tab flash — cut

---

Red-light (bonus B-roll only — not in 85s cut)

Toggle Red-light mode · SCOTOPIC MODE ACTIVE · optional ↻ Refresh Zenith.

Scotopic palette for outside — no white glare on dark-adapted eyes.

---

Full draft (reference — ~110s if you use everything)

Expand longer version with Targets + Ask Orion expanded

Use the tight list above first. Only add these if you have time after a clean 85s take.

Ask Orion (expanded): Best weekend in July for Cassiopeia? → review sidebar → Plan.

Targets flash: Open constellation guides → · finder steps · Plan this target →

Modal (longer): "That's the hackathon angle too — Modal for real runtime polish, not a bullet on a slide."

---

One-paragraph (YouTube description + X)

Orion's Cottage is a single field journal for rural stargazing. Skyfield + starplot give accurate zenith charts and rise times. Three small models (<4B each) turn the same facts into family English, Québec French, or a technical observatory brief. Runs great on Modal for speed, or fully Off-Grid. Built for the Build Small Hackathon.

---

YouTube

Title: Orion's Cottage — Nova Scotia stargazing planner (Build Small Hackathon)

Description: paste one-paragraph above +

Try it: https://huggingface.co/spaces/donniefi/orionscottage
Hackathon: https://huggingface.co/build-small-hackathon

#BuildSmallHackathon #HuggingFace #Gradio #Stargazing #Skyfield #MiniCPM #Nemotron #Modal

---

Social — one post on X

Paste post URL into README 📣 Social post (X) after publishing.

Orion's Cottage 🌌 — one field journal for rural Nova Scotia cottage skies.

Skyfield + starplot for real zenith charts (your target highlights in orange after Plan). Three models <4B each on the same facts: MiniCPM, Aya (FR), Nemotron. Parallel on Modal.

Demo: [link]
https://huggingface.co/spaces/donniefi/orionscottage

#BuildSmallHackathon #HuggingFace #Gradio #Stargazing

---

Models (on-camera cheat sheet)

Model	Say
MiniCPM ~4.6B	Warm English, family
Aya ~3.4B	Full Québec French
Nemotron 4B	Technical — RA/Dec, seeing, eyepiece (not "verbose")

Orion naming: AI persona = cottage journal / Ask Orion. Constellation = sky target (e.g. pick Orion).

---

Capture notes

• Landscape 16:9. Narrate while clicking — UI does the talking.
• Pause on Aya long enough for one French sentence.
• Product name: Orion's Cottage — not Midnight Oasis.
• Honest badges if polish fails — don't hide ✗.