Skip to content

Chapter 8.1 — Principles of the examples

When implemented, the examples must meet:

  • Easy to run and see by yourself. Clone and run with a single local command in up to 10 minutes.
  • Preferred open-source stack. Python 3.11+, FastAPI, Docker/Docker Compose, scikit-learn, pytest.
  • No mandatory dependency on paid credentials. When an example needs a cloud model, it has a documented local fallback (Ollama, vLLM, llama.cpp).
  • Local models via Ollama when possible.
  • Local vector DB (Qdrant or Chroma).
  • OpenTelemetry + Jaeger for tracing.
  • OPA/Rego for policy-as-code.
  • No real data or PII.

These principles are quality contracts for the examples, not suggestions.