CDS Agent — Demo Video Script
Target length: 3 minutes (max)
Format: Screen recording with voiceover
Tool suggestion: OBS Studio, Loom, or similar
PRE-RECORDING CHECKLIST
- Resume HF Endpoint
medgemma-27b-cds(~5–15 min cold start, ~$2.50/hr) - Start backend:
cd src/backend && uvicorn app.main:app --host 0.0.0.0 --port 8000 - Start frontend:
cd src/frontend && npm run dev - Open browser to
http://localhost:3000 - Close unnecessary tabs/notifications
- Test one case end-to-end before recording to confirm endpoint is warm
- Browser zoom ~110-125% for readability on video
SCRIPT
OPENING — The Problem (0:00 – 0:30)
[SCREEN: Title slide or the app landing page]
"Clinical decision-making is one of the most cognitively demanding tasks in medicine. For every patient, a clinician must simultaneously parse the history, generate a differential, recall drug interactions, remember guidelines, and synthesize a care plan — all under time pressure.
Diagnostic errors affect 12 million Americans annually. Many aren't from lack of knowledge — they're from the difficulty of integrating information from multiple sources at once.
CDS Agent solves this with an agentic pipeline powered by MedGemma."
LIVE DEMO — The Pipeline in Action (0:30 – 2:00)
[SCREEN: App interface — PatientInput component visible]
"Let me show you how it works. Here's a patient case — a 62-year-old male presenting with crushing substernal chest pain, diaphoresis, and nausea. He has a history of hypertension and diabetes, currently on lisinopril, metformin, and atorvastatin."
[ACTION: Click a sample case button OR paste the case text, then click Submit]
"When I submit this case, the agent pipeline kicks off. You can see each step executing in real time on the left."
[SCREEN: AgentPipeline component showing steps lighting up one by one]
"Step 1 — MedGemma parses the free-text narrative into structured patient data: demographics, vitals, labs, medications, allergies, history."
[Wait for Step 1 to complete, ~8 seconds]
"Step 2 — Clinical reasoning. MedGemma generates a ranked differential diagnosis with chain-of-thought reasoning. It's considering ACS, GERD, PE, aortic dissection — weighing evidence for and against each."
[Wait for Step 2 to complete, ~20 seconds]
"Step 3 — Drug interaction check. This isn't the LLM guessing — it's querying the actual OpenFDA and RxNorm databases for his three medications. Real API data, not hallucination."
[Wait for Step 3 to complete, ~11 seconds]
"Step 4 — Guideline retrieval. Our RAG system searches 62 curated clinical guidelines across 14 specialties. For this case it pulls the ACC/AHA chest pain and ACS guidelines."
[Wait for Step 4 to complete, ~10 seconds]
"Step 5 — and this is what makes it a real safety tool — Conflict Detection. MedGemma compares what the guidelines recommend against what the patient is actually receiving. It surfaces omissions, contradictions, dosage concerns, and monitoring gaps."
[Wait for Step 5 to complete]
"Step 6 — Synthesis. Everything gets integrated into a single comprehensive report."
[Wait for Step 6 to complete. Total pipeline ~60-90 seconds]
THE REPORT — Reviewing Results (2:00 – 2:40)
[SCREEN: Scroll through the CDSReport component]
"Here's the CDS report. At the top — the ranked differential diagnosis. ACS is correctly identified as the leading diagnosis, with clear reasoning."
[ACTION: Scroll to drug interactions section]
"Drug interaction warnings pulled from federal databases — not LLM-generated, real data."
[ACTION: Scroll to Conflicts & Gaps section — highlight the red-bordered cards]
"This is the most important section — Conflicts and Gaps. Each card shows a specific conflict: what the guideline recommends, what the patient data shows, the severity, and a suggested resolution. These are the gaps that lead to missed diagnoses and omitted treatments in real clinical practice."
[ACTION: Scroll to guidelines section]
"And finally, cited guideline recommendations from authoritative sources — ACC/AHA, ADA, and others."
CLOSING — Technical & Impact (2:40 – 3:00)
[SCREEN: Back to app overview or a summary slide]
"Under the hood: MedGemma 27B powers four of six pipeline steps — parsing, reasoning, conflict detection, and synthesis. It's augmented with OpenFDA and RxNorm APIs for drug safety, and a 62-guideline RAG corpus for evidence-based recommendations.
We validated on 50 MedQA USMLE cases with 94% pipeline reliability and 39% diagnostic mention rate on diagnostic questions — and that's before any fine-tuning.
With 140 million ED visits per year in the U.S. alone, even a modest improvement in diagnostic completeness and medication safety represents lives saved. CDS Agent is built to make that happen."
[END]
TIMING SUMMARY
| Section | Duration | Cumulative |
|---|---|---|
| Opening — The Problem | 30 sec | 0:30 |
| Live Demo — Pipeline Execution | 90 sec | 2:00 |
| Report Review | 40 sec | 2:40 |
| Closing — Tech & Impact | 20 sec | 3:00 |
TIPS
- Speak during pipeline wait times — the 60-90 sec pipeline execution is perfect narration time
- Don't rush — the real-time pipeline visualization IS the demo; let it breathe
- Zoom into the Conflicts section — it's the most visually impressive and differentiating feature
- If the endpoint is slow — you can speed up the wait portions in post-editing (1.5×–2× speed) while keeping narration at normal speed
- Backup plan — if the HF endpoint is down, you can use Google AI Studio with Gemma 3 27B IT as a fallback (update .env accordingly)