Agno SDK

Build your agent platform using the Agno SDK.

Agno is a Python SDK for building agent platforms. It gives you three primitives (agents, teams and workflows) and a large set of capabilities you can attach to them.

Before running these examples, follow the SDK setup, then install the optional packages and set your model key:

uv pip install -U "agno[openai,sqlite]" yfinance
export OPENAI_API_KEY="your_openai_api_key"
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.tools.workspace import Workspace

workbench = Agent(
    name="Workbench",
    model="openai:gpt-5.5",
    db=SqliteDb(db_file="workbench.db"),
    tools=[Workspace(".")],
    enable_agentic_memory=True,
    add_history_to_context=True,
    num_history_runs=3,
    markdown=True,
)

workbench.print_response("Inventory this folder.")

Choose the right primitive

PrimitiveUse it whenWhat Agno handles
AgentOne model-driven program can own the taskContext, tool calls, sessions, memory, knowledge, and guardrails
TeamThe task benefits from specialist roles or dynamic delegationCoordination, routing, broadcast, task lists, and nested teams
WorkflowThe process needs repeatable steps, branches, loops, or parallel workControl flow across agents, teams, functions, and nested workflows

Add what your use case needs

Model and tools

CapabilityWhat it adds
Models30+ providers behind one API
Tools100+ integrations and the ability to write your own
SkillsComposable abilities you attach to agents and teams
MultimodalImage, audio, and video input and output
Structured I/OType-safe input and output with Pydantic schemas

Memory and context

CapabilityWhat it adds
StorageSession and application data in a supported database
SessionsMulti-turn sessions with summaries, history, and metrics
StateState your agents can read and update mid-run
MemoryPersistent user facts and preferences
KnowledgeSearch over documents, URLs, and databases
LearningAgents that improve over time from feedback and outcomes
CompressionReduce context usage in long sessions
Context ProvidersInject live data from Calendar, Gmail, Drive, GitHub, Slack, MCP
DependenciesInject runtime values into prompts

Control and safety

CapabilityWhat it adds
GuardrailsValidate input and output
HooksPre-run and post-run callbacks
Human-in-the-LoopPause runs for approval, input, or external execution

Operations

CapabilityWhat it adds
Background executionLong-running runs that don't block your API
EvalsMeasure accuracy, performance, and reliability
ObservabilityOpenTelemetry tracing into your own database
SchedulerRun agents and workflows on a recurring schedule

From SDK to platform

Register the same agents, teams, and workflows with AgentOS to run them behind a FastAPI application. AgentOS provides REST APIs and runtime support for persistence, authorization, tracing, background execution, scheduling, and interfaces.

Where to start