Capítulo 8.1 — Princípios dos exemplos

Quando forem implementados, os exemplos devem cumprir:

• Easy to run and see by yourself. Clonar e rodar com um único comando local em até 10 minutos.
• Stack open-source preferida. Python 3.11+, FastAPI, Docker/Docker Compose, scikit-learn, pytest.
• Sem dependência obrigatória de credenciais pagas. Quando um exemplo precisar de modelo na nuvem, terá fallback local documentado (Ollama, vLLM, llama.cpp).
• Modelos locais via Ollama quando possível.
• Vector DB local (Qdrant ou Chroma).
• OpenTelemetry + Jaeger para tracing.
• OPA/Rego para policy-as-code.
• Sem dados reais nem PII.

Estes princípios são contratos de qualidade dos exemplos, não sugestões.