Ramis
232 lines
11 KiB
Markdown
232 lines
11 KiB
Markdown
# PodMan — Demo Scripts
|
||
|
||
**Theme:** Continual Learning. Two scripts below: a **1-minute live script**
|
||
(§ first) for showing real-time interventions fast with teammates, and the full
|
||
**4-minute script** for the complete story. Practice the 4-min to land at 3:45.
|
||
|
||
**The thesis (say this first, in either script):** AI is collapsing the cost of
|
||
*writing* code. More and more of every codebase is authored with AI assist — and
|
||
increasingly by **autonomous agents**. So the bottleneck of software engineering
|
||
is shifting away from engineering itself toward **organization, management, and
|
||
project coordination**. Pair a team with hundreds of agents all committing to the
|
||
same repo at once and it becomes **physically impossible for a human to track
|
||
progress or avoid stepping on someone else's work.** Code generation scaled;
|
||
human coordination did not. That gap is the new bottleneck.
|
||
|
||
**The one-line story:** writing code isn't the bottleneck anymore — *coordinating
|
||
who (and what) is writing what* is. PodMan is a pair programmer for the whole
|
||
team — humans **and** agents: it watches every actor's work in real time, gives
|
||
everyone live status without anyone having to interrupt anyone, catches collisions
|
||
before they land, and learns your team's dynamics so it nudges less and helps more
|
||
over time.
|
||
|
||
**The hook to land:** a "quick five-minute question" actually costs ~25 minutes of
|
||
lost focus — for two people. Now multiply that across a team plus a swarm of
|
||
agents nobody can watch. PodMan removes the reason to ask and surfaces the
|
||
collision no human could have caught in time. That recovery time, saved across
|
||
every actor, every day, is the value.
|
||
|
||
---
|
||
|
||
|
||
|
||
## 1-Minute Live Script (you + teammates — real-time interventions)
|
||
|
||
**Hard limit 1:00.** Hits the tracks: real-time multimodal, on-device Gemma,
|
||
Continual Learning, Self-Improvement, Recursive Intelligence.
|
||
|
||
**Pre-flight:** pod open on `podman.live`, all joined, screen share + **sound on**;
|
||
git watchers running; everyone has `README.md` open. On-device **Gemma** must be
|
||
up as Hermes's voice (else Gemini TTS auto-falls-back — just drop the "on-device"
|
||
word).
|
||
|
||
**0:00–0:12 — Thesis**
|
||
> "Code is almost free to write now — humans with AI, soon swarms of agents, all
|
||
> on one repo. No human can track that. The bottleneck is coordination — and it
|
||
> has to fix itself, live. Watch."
|
||
|
||
**0:12–0:35 — Collision caught live (money shot)**
|
||
- You + a teammate both edit `README.md`, save (unpushed).
|
||
- Card appears on every screen + voice fires: _"<you> and <teammate> are both
|
||
editing README.md. Sync before pushing."_
|
||
- Say: "Gemini Vision reads our screens, fused with local git, in real time —
|
||
and the alert is **spoken by a Gemma model on-device**. Neither of us asked."
|
||
|
||
**0:35–0:52 — Self-improving (narrate)**
|
||
- Third teammate edits too → **new** card + voice for the new pair (never goes
|
||
silent).
|
||
- Say: "Every trace lands in **Atlas**; vector search recalls past collisions,
|
||
repeats come back tagged **'Seen before'** and escalate — no retraining. It
|
||
tunes its own coordination from its own outcomes."
|
||
|
||
**0:52–1:00 — Close**
|
||
> "Real-time awareness, on-device voice, a coordination layer that improves
|
||
> itself — for humans and agents, zero interruptions."
|
||
|
||
_Fallback:_ Gemma down → drop the on-device line. Voice silent → read it, point
|
||
at the card. No card → switch the pair to a fresh file and re-save.
|
||
|
||
---
|
||
|
||
|
||
|
||
## The script (4:00)
|
||
|
||
|
||
|
||
### 0:00–0:30 — The problem + hook
|
||
|
||
> "AI made writing code almost free — humans with AI today, swarms of autonomous
|
||
> agents tomorrow, all committing to the same repo. The bottleneck stopped being
|
||
> engineering and became coordination: checking each other's work, re-planning
|
||
> collisions, the constant 'what are you working on?' At agent scale no human can
|
||
> even track it. A five-minute question already costs both people 25 minutes of
|
||
> lost focus. PodMan is a pair programmer for the whole team — humans and agents:
|
||
> it watches everyone's work live, so anyone sees another's status without
|
||
> interrupting them, catches collisions before they land, and learns your team as
|
||
> it goes."
|
||
|
||
*On screen:* the pod view, two teammates joined, screen-share tiles live.
|
||
|
||
### 0:30–1:05 — Real-time team awareness (LiveKit + Gemini Vision)
|
||
|
||
- Point at the two live screen tiles. "These are real screen shares over
|
||
**LiveKit**. Our agent subscribes to the tracks and samples frames."
|
||
- "Each frame goes to **Gemini Vision**, which returns structured context — file,
|
||
symbol, activity — not a chatbot, a perception layer."
|
||
- Show the live activity stream filling in (Signals vs Reasoning sections).
|
||
- Land the value: "This is the part that replaces 'what are you working on?' —
|
||
every teammate's current work is just *visible*, in real time. Nobody had to
|
||
ask."
|
||
|
||
*Built-by-us callout:* `backend/src/vision/gemini.ts`, the LiveKit agent worker.
|
||
|
||
### 1:05–1:40 — The catch (detection + first intervention)
|
||
|
||
- Have alice and bob both edit the **same file** with unpushed changes.
|
||
- "Normally nobody notices until merge time. GitHub can't see this — nothing's
|
||
pushed. Our detector fuses live screen context with **local git truth** from a
|
||
watcher on each laptop."
|
||
- A collision card appears: *"alice + bob both on detector.ts (unpushed)."*
|
||
- Let the **Gemini TTS** urgent voice fire once over LiveKit: *"alice and bob are
|
||
both editing detector.ts. Please sync before pushing."*
|
||
- Land the value: "That's a merge conflict and a wasted afternoon caught before it
|
||
happened — and neither of them had to be tracking the other."
|
||
|
||
*Built-by-us callout:* `collision/detector.ts`, `action/hermes.ts`,
|
||
`voice/live.ts`.
|
||
|
||
### 1:40–2:10 — Cross-channel overlap (research + code)
|
||
|
||
- Keep alice editing `livekit.py`.
|
||
- Have bob share a browser tab on LiveKit docs/SDK pages.
|
||
- A collaboration nudge appears: *"🤝 bob is researching LiveKit agents
|
||
(docs.livekit.io) while alice edits livekit.py — sync up before duplicating
|
||
effort."*
|
||
- Land the value: "This is not a merge conflict. PodMan caught duplicated effort
|
||
across channels — code on one screen, research on another — and nudged the team
|
||
before two people solved the same problem twice."
|
||
|
||
*Built-by-us callout:* `vision/gemini.ts`, `collision/research.ts`,
|
||
`memory/vectors.ts`.
|
||
|
||
### 2:10–2:50 — Continual learning (the theme — the money shot)
|
||
|
||
This is the differentiator. Two beats, both from pre-seeded memory:
|
||
|
||
1. **It learned to stay quiet.** Trigger a pattern that was dismissed as a false
|
||
alarm earlier. "Last session a teammate marked this kind of alert as not a
|
||
real conflict. Watch — PodMan stays silent. No nagging." (No card fires.)
|
||
2. **It learned to escalate.** Trigger the real-conflict pattern that was
|
||
accepted before. The card now says **"Seen before."** and goes straight to
|
||
the spoken urgent cue.
|
||
|
||
- "The only input was one accept/dismiss tap. No retraining, no labeling. This is
|
||
**MongoDB Atlas vector search** recalling similar past events plus a policy
|
||
that adapts on the recalled outcome."
|
||
- Optional: show `/api/memory/stats` counts climbing — accumulated experience.
|
||
|
||
*Built-by-us callout:* `memory/vectors.ts` ($vectorSearch), `memory/policy.ts`
|
||
(outcome-conditioned gate), `memory/store.ts`.
|
||
|
||
### 2:50–3:30 — The five-minute meeting, killed (Gemini Live API)
|
||
|
||
- Frame it: "Instead of breaking a teammate's focus to ask what they're up to,
|
||
you ask PodMan."
|
||
- Open the live voice conversation. Ask out loud: *"PodMan, what is everyone
|
||
working on, and where is the collision detector implemented?"*
|
||
- It answers with **real tool calls** — `search_repo`, git history, current
|
||
collisions — not guesses.
|
||
- "This is the **Gemini Live API**, streaming speech-to-speech over LiveKit, with
|
||
custom function tools we wrote so it grounds every answer in the actual repo
|
||
and live state. That's the status sync, answered in seconds, with zero recovery
|
||
tax on anyone else."
|
||
|
||
*Built-by-us callout:* `agents/podman-live-conversation/agent.py`.
|
||
|
||
### 3:30–3:50 — Stack + close
|
||
|
||
- "All on **DigitalOcean** — static frontend, API, and agent workers, supervised
|
||
by systemd. The ambient score is **Gemini Lyria** generated per pod through the
|
||
Interactions API."
|
||
- Close: "Engineering ability stopped being the bottleneck — coordination is, and
|
||
it only gets worse as agents start writing alongside us. PodMan gives a whole
|
||
team, humans and agents, real-time awareness without the interruptions, catches
|
||
collisions before they cost an afternoon, and learns each team's dynamics so it
|
||
helps more over time. Saved focus, multiplied across every actor. That's
|
||
continual learning, shipped."
|
||
|
||
|
||
|
||
### 3:50–4:00 — Buffer / Q&A handoff
|
||
|
||
---
|
||
|
||
|
||
|
||
## Sponsor-prize coverage (say each at least once)
|
||
|
||
|
||
| Prize | Spoken moment | Segment |
|
||
| ---------------- | -------------------------------------------------------------------------------- | ---------------------- |
|
||
| **Gemini** | Vision perception, Live API agent w/ tools, TTS voice, Lyria score | 0:30, 1:05, 2:50, 3:30 |
|
||
| **LiveKit** | "real screen shares over LiveKit", agent subscribes, TTS audio track, live voice | 0:30, 1:05, 3:30 |
|
||
| **MongoDB** | "Atlas vector search recalling past events" | 1:50 |
|
||
| **DigitalOcean** | "all on DigitalOcean, systemd-supervised workers" | 3:30 |
|
||
|
||
|
||
---
|
||
|
||
|
||
|
||
## If something breaks (live recovery)
|
||
|
||
|
||
| Failure | Recovery |
|
||
| ----------------------- | ----------------------------------------------------------------------- |
|
||
| Voice doesn't fire | Cut to the card; say the line aloud; cards are the default path anyway. |
|
||
| Live conversation drops | Skip 2:50–3:30; lean longer on the learning beat. |
|
||
| Collision won't trigger | Use the backup recording for that beat; keep narrating. |
|
||
| Agent flapping | Pre-checked — but if so, `systemctl restart podman-platform-agent`. |
|
||
|
||
|
||
**Rule:** never debug on stage. Narrate, fall back to recording, keep moving.
|
||
|
||
---
|
||
|
||
|
||
|
||
## Tight timing summary
|
||
|
||
|
||
| Time | Beat |
|
||
| ---- | ---------------------------------------------------------- |
|
||
| 0:00 | Problem (coordination cost) + hook + original-work line |
|
||
| 0:30 | Real-time team awareness — LiveKit + Gemini Vision |
|
||
| 1:05 | The catch — collision caught before merge |
|
||
| 1:40 | Cross-channel overlap — research + code nudge |
|
||
| 2:10 | **Continual learning — quiet + escalate** |
|
||
| 2:50 | The five-minute meeting, killed — Gemini Live conversation |
|
||
| 3:30 | DigitalOcean + Lyria + close |
|
||
| 3:50 | Buffer |
|