Skip to content

ajshedivy/agno-cookbook

Repository files navigation

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.

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:8000

Skill Structure

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

About

customizable agno examples and demos

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages