Cookbook examples for Agno with configurable model selection. Switch models via .env instead of editing code.
# Clone and setup
git clone <repo-url> && cd agno-cookbook
cp .env.example .env
# Install dependencies + your provider SDK
uv sync --extra quickstart --extra anthropic
# Run an example
uv run python cookbook/00_quickstart/agent_with_tools.pyEdit .env with your API key and preferred model:
AGNO_MODEL=anthropic:claude-sonnet-4-20250514
ANTHROPIC_API_KEY=sk-ant-...Set AGNO_MODEL in .env using the format provider:model_id. Agno supports 40+ providers.
You must install the provider's SDK via uv sync --extra <provider>:
AGNO_MODEL |
Install command | API key env var |
|---|---|---|
openai:gpt-4o |
uv sync --extra openai |
OPENAI_API_KEY |
anthropic:claude-sonnet-4-20250514 |
uv sync --extra anthropic |
ANTHROPIC_API_KEY |
google:gemini-3-flash-preview |
uv sync --extra google |
GOOGLE_API_KEY |
groq:llama-3.3-70b-versatile |
uv sync --extra groq |
GROQ_API_KEY |
mistral:mistral-large-latest |
uv sync --extra mistral |
MISTRAL_API_KEY |
cohere:command-r-plus |
uv sync --extra cohere |
COHERE_API_KEY |
ollama:llama3.2 |
uv sync --extra ollama |
(none — runs locally) |
You can combine multiple extras:
uv sync --extra quickstart --extra anthropic # Quickstart tools + Anthropic
uv sync --extra all-models # All major provider SDKsThe agentos-serve package lets you spin up AgentOS from any Python file containing Agno agents, teams, or workflows.
uv pip install -e agentos-serveOr install it via the serve extra (non-editable, from PyPI):
uv sync --extra serve# Serve a single file
agentos-serve cookbook/02_agents/01_quickstart/basic_agent.py
# Serve all agents in a directory
agentos-serve cookbook/02_agents/01_quickstart/
# The cookbook also provides an `agentos` alias
uv run agentos cookbook/02_agents/01_quickstart/See agentos-serve/README.md for full CLI options and extras.
cookbook/
00_quickstart/ # Start here
01_demo/ # Full demo app
02_agents/ # Agent patterns
03_teams/ # Multi-agent teams
04_workflows/ # Workflow orchestration
05_agent_os/ # Agent OS examples
06_storage/ # Persistence
07_knowledge/ # Knowledge bases & embedders
08_learning/ # Self-learning agents
09_evals/ # Evaluation patterns
10_reasoning/ # Reasoning strategies
11_memory/ # Memory management
90_models/ # Provider-specific demos (hardcoded models)
91_tools/ # Tool integrations
92_integrations/ # Third-party integrations
93_components/ # UI components
Note:
cookbook/90_models/contains provider-specific examples with hardcoded model classes. These are intentionally not configurable — they demonstrate provider-specific features.
The plugins/ directory contains agent skill packs that provide domain-specific guidance, CLI scripts, and API reference patterns for building with the Agno ecosystem.
Install skills as Claude Code plugins:
# Add the marketplace from GitHub
claude plugin marketplace add ajshedivy/agno-cookbook
# Install the skill packs
claude plugin install agno-framework
claude plugin install agno-agentos-apiOnce connected, skills activate automatically based on context — asking Claude to "create an Agno agent with tools" triggers agno-agent, and "list my agents on AgentOS" triggers agentos-api-agents.
13 skills covering all major Agno framework areas:
| Skill | Description |
|---|---|
agno-agent |
Agent creation, configuration, and tool binding |
agno-team |
Multi-agent team orchestration |
agno-workflow |
Workflow orchestration patterns |
agno-agentos |
AgentOS server setup and deployment |
agno-tools |
Tool development and integration |
agno-knowledge |
Knowledge bases and RAG |
agno-memory |
Memory and session management |
agno-storage |
Persistence backends |
agno-models |
Model providers and configuration |
agno-reasoning |
Reasoning strategies |
agno-multimodal |
Image, audio, and video support |
agno-guardrails |
Input/output validation |
agno-test |
Testing and evaluation patterns |
8 skills for interacting with a running AgentOS instance via the AgentOSClient SDK. Each skill includes a CLI script for common operations and reference docs for advanced usage.
| Skill | Description |
|---|---|
agentos-api-agents |
List, run, and stream agents |
agentos-api-teams |
List and run teams |
agentos-api-workflows |
List and run workflows |
agentos-api-sessions |
Manage sessions and run history |
agentos-api-memory |
Read/write agent memories |
agentos-api-knowledge |
Upload, search, and manage knowledge |
agentos-api-evals |
Run accuracy and performance evaluations |
agentos-api-traces |
Inspect traces and token usage |
Example — list all agents on a running AgentOS:
uv run scripts/run_agents.py --base-url http://localhost:8000Each skill is a directory with a SKILL.md manifest, optional scripts, and reference docs:
plugins/
agno-framework/
skills/
agno-agent/
SKILL.md # Trigger rules, instructions, examples
references/
api-patterns.md # Detailed API reference
agno-agentos-api/
skills/
agentos-api-agents/
SKILL.md
scripts/
run_agents.py # CLI script for common operations
references/
api-patterns.md
See the plugins/ directory for full skill definitions and reference documentation.