Caber Demo CLI Reference (demo.py)
The unified runner demo.py in CaberDemos orchestrates Docker Compose stacks, dataset seeding, automated verification, and cloud deployments across all four active demo scenarios (agentic-tools, hipaa-ner, agentgov-mimic, graphrag).
These commands are designed for interactive evaluation and engineering walk throughs:
demo.py list
Lists all available demo scenarios defined in catalog.yaml along with their status, ports, and default datasets.
demo.py info <demo>
Displays detailed configuration for a scenario, including Docker services, port mappings, and environment variables.
demo.py check [demo]
Verifies prerequisite tooling on the host machine, including Docker Engine, Docker Compose v2, Python version, and network port availability.
demo.py up <demo>
Launches the demo environment and seeds initial data.
| Flag | Type | Default | Description |
|---|---|---|---|
--no-visible | Flag | False | Run browser interactions in headless mode |
--slow-mo | Integer | 300 | Delay browser actions by N milliseconds for demonstration visibility |
--no-keep-open | Flag | False | Close browser window automatically after seeding completes |
--no-seed | Flag | False | Skip initial dataset seeding |
--dashboard | Flag | False | Launch CaberUserConsole dashboard alongside the demo |
--dataset | String | None | Named dataset from data/ to mount at /demo-data |
demo.py down <demo>
Tears down Docker containers, volumes, and networks associated with the specified scenario.
2. CI & Automated Verification Workflows
demo.py ci <demo>
Executes full lifecycle testing: launch, seed, test assertions, and teardown.
| Flag | Type | Default | Description |
|---|---|---|---|
--output-dir | Path | None | Directory to store test artifacts and logs |
--dashboard | Flag | False | Launch CaberUserConsole for end to end audit verification |
--generate | Flag | False | Generate fresh ground truth data via CaberDataFactory before launch |
--verdict | Flag | False | Enable deployed NER verdict pass and enforce GLiNER validation gates |
--warn-on-auth-gap | Flag | False | Downgrade auth correctness errors to visible warnings |
demo.py test <demo>
Executes smoke tests and policy enforcement checks against an already running demo stack.
3. Multimedia, Build & Cloud Workflows
demo.py video <demo>
Records an automated video walkthrough with synchronized narration:
--tts: Text to speech engine (openaior macOSsay)--resolution: Output resolution (4kor1080p)
demo.py build [demo]
Builds demo application containers or core platform services (--platform).
demo.py deploy <demo> & undeploy <demo>
Provisions demo infrastructure into AWS (--target aws) with optional automatic teardown (--ttl 4h).