Pharmacogenomics — Demo Guide

Demo key: A3 · full specification in ../../demos/DEMO_CATALOG.md

Run it

.venv/bin/python scripts/run_demo.py A3

Check prerequisites without running anything:

.venv/bin/python scripts/run_demo.py --check-all

What the audience is seeing

Explains why two patients given the same dose of the same drug can have completely different outcomes.

Genotype-guided dosing has CPIC guidelines behind it. For DPYD and fluorouracil the stakes are toxicity, not efficacy.

Say this out loud

Decision support for a qualified clinician — never autonomous diagnosis or prescribing. Every output on this page is intended to inform a clinician's judgement, not replace it.

CPIC guidance covers specific gene-drug pairs. Substrate relationships outside those pairs are pharmacology, not guideline-backed dosing advice.

The label matters. LIVE means it ran, now, on real input, in front of the room. REPRESENTATIVE means a pre-computed or curated result is standing in for a long or gated step — and you say so. BURST means it ran live but on remote GPUs, which is "elastic burst", not "all on one box".

If it will not run

The runner refuses to execute a demo declared LIVE whose service is unreachable, rather than quietly degrading to a canned result. The failure message names the missing prerequisite:

• a service not listening → start it (docker compose -f docker-compose.dgx-spark.yml up -d)
• a missing Python package → install it
• a gated component → see ../../build/GATED_SOFTWARE_BUILD_GUIDE.md

Transcript

Each run writes demo/transcripts/A3.txt. Diff it after a change — a silent regression shows up there before anyone notices it on stage.