docs/demo_script.md

ReplicaLab -- One-Minute Demo Script

Total duration: 60 seconds

---

Scene 1: Hook (0:00 -- 0:08)

Visual: Dashboard landing page with 3D molecule background and three animated characters.

Narration / Caption:

"Most ML papers can't be reproduced. ReplicaLab trains an AI agent to negotiate realistic replication plans -- under real constraints."

---

Scene 2: The Cast (0:08 -- 0:16)

Visual: Scroll down to "Meet the Cast" section. Hover over each tilt card to show the 3D effect.

Narration / Caption:

"Three roles: Dr. Elara proposes plans. Takuma enforces GPU budgets, schedules, and resource limits. Aldric judges the result."

---

Scene 3: Start an Episode (0:16 -- 0:24)

Visual: Click "Run Episode". Select ML Benchmark, Medium difficulty. Click "Start Episode".

Narration / Caption:

"Each episode generates a seeded scenario. Here: replicate a ViT fine-tuning result with a limited GPU budget."

---

Scene 4: Negotiation (0:24 -- 0:38)

Visual: Show the CharacterStage with Scientist and Lab Manager animated. Scroll through the negotiation log showing the proposal, feasibility report, and revised protocol.

Narration / Caption:

"The Scientist proposes 5 seeds on A100s. The Lab Manager flags the budget overshoot. The Scientist revises down to 3 seeds -- staying within budget while keeping A100 for compute fidelity."

---

Scene 5: Judge Verdict (0:38 -- 0:48)

Visual: Click "Step". Show the Judge appearing center-stage with gavel sound. Score card reveals total reward 8.12 with R/F/D breakdown.

Narration / Caption:

"Judge Aldric scores the plan: 85% rigor, 93% feasibility, 80% fidelity. Total reward: 8.12 out of 10. The multiplicative formula means every dimension matters."

---

Scene 6: Training Results (0:48 -- 0:56)

Visual: Show the Training Results panel with the before/after toggle. Click the toggle to show baseline vs. trained curves.

Narration / Caption:

"After RL training with GRPO, the Scientist improves: 67% higher reward, 32% fewer rounds, and the invalid action rate drops from 15% to 4%."

---

Scene 7: Close (0:56 -- 1:00)

Visual: Return to dashboard hero with all three characters. Show the HF Space URL.

Narration / Caption:

"ReplicaLab. An OpenEnv world where agents learn to negotiate science."

---

Backup Notes

• Pre-tested seed: Use seed 42 with ml_benchmark / medium for a reliable demo.
• Fallback: If the custom UI fails, navigate to /web on the HF Space for the OpenEnv built-in interface.
• Audio: The app has built-in sound effects. Keep speakers on for a richer demo, or mute if presenting in a noisy venue.