agno-framework

Agno Cookbook

Cookbook examples for Agno with configurable model selection. Switch models via .env instead of editing code.

Quick Start

# 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.py

Edit .env with your API key and preferred model:

AGNO_MODEL=anthropic:claude-sonnet-4-20250514
ANTHROPIC_API_KEY=sk-ant-...

Model Configuration

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 SDKs

AgentOS

The agentos-serve package lets you spin up AgentOS from any Python file containing Agno agents, teams, or workflows.

Install (editable mode, for development)

uv pip install -e agentos-serve

Or install it via the serve extra (non-editable, from PyPI):

uv sync --extra serve

Usage

# 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.

Directory Structure

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.

Agent Skills

The plugins/ directory contains agent skill packs that provide domain-specific guidance, CLI scripts, and API reference patterns for building with the Agno ecosystem.

Connecting Skills to Claude Code

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-api

Once 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.

agno-framework — Agno SDK Development

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

agno-agentos-api — AgentOS Client API

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.