Single-Cell Intelligence — Demo Guide

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

Run it

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

Check prerequisites without running anything:

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

What the audience is seeing

Interprets what single-cell clustering results mean clinically.

The engine computes; the agent explains. Nine clusters are a result — what they imply for this patient is an interpretation.

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.

Interpretation rests on the quality of the upstream clustering and the marker panel used.

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/A8.txt. Diff it after a change — a silent regression shows up there before anyone notices it on stage.