Frame the local Ollama router experiment

A lab needs a falsifiable claim before code. The claim here is that you can answer allowed tasks locally when hardware permits, otherwise follow an explicit fallback policy. Record the tiny dataset, expected behavior, and one reason the result could be misleading. The first artifact is an experiment brief, not a screenshot. It names the user decision, the baseline you must beat, and the non-goals you will not pretend to solve on this page.

Local models trade cloud convenience for privacy and hardware reality. A laptop that demos once may thrash under longer contexts. Write the envelope: model tag, minimum tokens/sec, memory ceiling, and whether cloud fallback is ever allowed.

The artifact's user-facing goal is specific: answer allowed tasks locally when hardware permits, otherwise follow an explicit fallback policy. Its accepted input is prompt, model tag, timeout, and policy flags for whether cloud fallback is allowed. Those statements are intentionally narrower than “build an AI system.” Narrow scope lets us inspect every input and expected result, and it prevents a toy result from being presented as a production claim. System shape for this chapter: Ollama manages model weights and a local HTTP inference process; a thin application adapter applies a system policy, timeouts, and structured logging; an evaluation harness compares quality, tokens per second, memory use, and privacy requirements before enabling cloud fallback. Keep model calls behind adapters, keep authorization and validation in deterministic code, and carry stable IDs and versions through every response. That separation lets you decide whether a bad result came from input handling, retrieval, inference, validation, or deployment. This page's job is the experiment brief step: a lab needs a falsifiable claim before code. Setup baseline for the chapter (run once per machine, not secrets in git):

# Install Ollama from the official site for your OS, then:
ollama pull llama3.2:1b
python -m venv .venv && source .venv/bin/activate
pip install httpx

If hardware or a hosted provider differs, preserve the interface and expected behavior. Do not present provider syntax as universal—when a vendor adapter is unavoidable, keep it behind a thin boundary and test with a fake first. The deliverable is not “it ran once”; it is a reproducible artifact another developer can inspect, including expected output and one deliberate failure related to hanging local inference or silent privacy-violating fallback. Operationally, write down the owner of this stage, the command you ran, the observed output, and the next page's dependency on that output. If you cannot point to a file, fixture, metric, or config key, the stage is not done. Prefer small, reviewable increments: one contract, one path, one metric, one failure, one gate. When tradeoffs appear—latency versus quality, hit rate versus false hits, local privacy versus cloud quality—record both numbers instead of moving the threshold until the report looks green. The chapter ships only when evidence for golden task pass rate, tokens/sec, peak memory, and fallback rate within policy and a rehearsed recovery path exist beside local-first router with LOCAL_MODEL_ID and ALLOW_CLOUD_FALLBACK pins.

Save this as lesson.py and run python3 lesson.py. Prefer the standard library or the pinned packages from the setup block so the example stays reproducible.

envelope={"model":"llama3.2:1b","min_tokens_per_s":5,"max_rss_gb":8,"allow_cloud_fallback":False}
print(envelope)

Expected output: hardware envelope dict. Exact floating-point formatting may vary slightly, but the asserted behavior must not. Read the output as evidence about this stage, not merely proof that the interpreter started.

Print the planned interfaces and the one fixture that would falsify the brief. If tenant, version, timeout, or refusal behavior is missing from the brief, stop before installing packages. At the experiment brief stage, save the smallest failing fixture beside the expected result. Change one cause at a time and rerun the exact command printed above; that makes the repair reviewable and keeps this chapter's progressive artifact reproducible.

Preserve the acceptance brief beside the fixture. Connecting tools is not the same as meeting golden task pass rate, tokens/sec, peak memory, and fallback rate within policy. For this experiment brief page, preserve the fixture and result as evidence for the next page. Label observations separately from conclusions: a passing assertion establishes the behavior it names, while broader usefulness requires the chapter's full evaluation set and stated operating limits. Primary metrics for the chapter remain golden task pass rate, tokens/sec, peak memory, and fallback rate within policy.