Control demo
Run KazenAI budget enforcement without provider keys.
Clone and install
Section titled “Clone and install”git clone https://github.com/kazenai-ai/kazenai-demo-agent.gitcd kazenai-demo-agentpython3.11 -m venv .venvsource .venv/bin/activatepython -m pip install -U pippython -m pip install -r requirements.txtPinned packages:
kazenai==1.2.0kazen-event-schema==0.6.6
Offline proof: zero provider calls
Section titled “Offline proof: zero provider calls”python -m pytest scenarios -qpython examples/02_monitor_fake_provider.py02_monitor_fake_provider.py wraps a fake OpenAI client with a tiny budget.
Expected result: BudgetExceeded and provider_calls: 0.
Hosted MultiSink (opt-in only)
Section titled “Hosted MultiSink (opt-in only)”Hosted examples refuse unless KAZENAI_DEMO_HOSTED=1 is set, and they never
ship credentials or real tenant identifiers in the repository.
# Refuses without the gate:python examples/03_monitor_multisink_hosted.pyWhat this demo proves
Section titled “What this demo proves”- Pre-dispatch denial works without paid I/O
- The public install path is standalone (no sibling monorepo required)
It does not prove production savings or provider-invoice exactness. The demo pins 1.2.0; the full supported surface (including async and streaming) is listed in Supported surfaces.
