cookbook/README.md
Hundreds of examples. Copy, paste, run.
New to Agno? Start with 00_quickstart — it walks you through the fundamentals, with each cookbook building on the last.
Want to see something real? Jump to 01_demo — advanced use cases. Run the examples, break them, learn from them.
Want to explore a particular topic? Find your use case below.
02_agents — The atomic unit of Agno. Start here for tools, RAG, structured outputs, multimodal, guardrails, and more.
03_teams — Coordinate multiple agents. Async flows, shared memory, distributed RAG, reasoning patterns.
04_workflows — Chain agents, teams, and functions into automated pipelines.
05_agent_os — Deploy to web APIs, Slack, WhatsApp, and more. The control plane for your agent systems.
06_storage — Give your agents persistent storage. Postgres and SQLite recommended. Also supports DynamoDB, Firestore, MongoDB, Redis, SingleStore, SurrealDB, and more.
07_knowledge — Give your agents information to search at runtime. Covers chunking strategies (semantic, recursive, agentic), embedders, vector databases, hybrid search, and loading from URLs, S3, GCS, YouTube, PDFs, and more.
08_learning — Unified learning system for agents. Decision logging, preference tracking, and continuous improvement.
09_evals — Measure what matters: accuracy (LLM-as-judge), performance (latency, memory), reliability (expected tool calls), and agent-as-judge patterns.
10_reasoning — Make agents think before they act. Three approaches:
reasoning=True for chain-of-thought with tool use11_memory — Agents that remember. Store insights and facts about users across conversations for personalized responses.
90_models — 40+ model providers. Gemini, Claude, GPT, Llama, Mistral, DeepSeek, Groq, Ollama, vLLM — if it exists, we probably support it.
91_tools — Extend what agents can do. Web search, SQL, email, APIs, MCP, Discord, Slack, Docker, and custom tools with the @tool decorator.
92_integrations — Connect to Discord, observability tools (Langfuse, Arize Phoenix, AgentOps, LangSmith), memory providers, and A2A protocol.
For every cookbook folder that contains runnable Python examples, include:
README.md explaining intent, prerequisites, and run commandsTEST_LOG.md recording run status and observationsUse cookbook/STYLE_GUIDE.md
Enforce in checks (fails on missing metadata):
python3 cookbook/scripts/audit_cookbook_metadata.py --scope direct --fail-on-missing
Check cookbook Python structure pattern:
python3 cookbook/scripts/check_cookbook_pattern.py --base-dir cookbook/00_quickstart
Run cookbooks in non-interactive batch mode with demo environment defaults:
python3 cookbook/scripts/cookbook_runner.py cookbook/00_quickstart --batch --python-bin .venvs/demo/bin/python
Write machine-readable run report:
python3 cookbook/scripts/cookbook_runner.py cookbook/00_quickstart --batch --json-report .context/cookbook-run.json
We're always adding new cookbooks. Want to contribute? See CONTRIBUTING.md.