Agent SDK

Build your agent platform in pure Python.

Agno is a Python SDK for building agents and multi-agent systems. It provides three primitives (agents, teams, and workflows) plus capabilities such as storage, memory, knowledge, learning, and compression. A primitive and its capabilities form a component in your agent platform. Everything is pure Python. No new DSL to learn, no YAML to manage.

uv pip install -U "agno[openai,sqlite]"

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(".")],
    add_history_to_context=True,
    markdown=True,
)

workbench.print_response("Inventory this folder.")

An agent (the primitive) with a model, tools, storage, and session history (the capabilities) is a component you can serve on the AgentOS runtime.

Primitives

Primitive	Description
Agent	Model-driven programs with tools and instructions
Team	Multiple agents working together as a team
Workflow	Explicit step-based orchestration for agents, teams, and functions

Capabilities

Model and tools

Capability	What it adds
Models	30+ providers behind one API
Tools	100+ integrations and the ability to write your own
Skills	Composable abilities you can attach to agents and teams
Multimodal	Image, audio, and video input and output
Structured I/O	Type-safe input and output with Pydantic schemas

Memory and context

Capability	What it adds
Storage	Durability and persistence with supported database backends
Sessions	Multi-turn session management with summaries, history, and metrics
State	Session and agentic state agents can read and update mid-run
Memory	Store facts about each user and recall them in later conversations
Knowledge	Search over documents, URLs, and databases
Learning	Agents that improve over time with learned behavior and decisions
Compression	Compress tool call results to save context space
Context Providers	Inject live data from Calendar, Gmail, Drive, Slack, Wiki, MCP, and more

Control and safety

Capability	What it adds
Guardrails	Input validation, PII detection, and prompt injection defense
Hooks	Lifecycle hooks for input, output, and state
Human-in-the-Loop	Pause runs for approval, input, or external execution

Operations

Capability	What it adds
Background execution	Long-running runs that don’t block your API
Evals	Measure accuracy, performance, and reliability; agent-as-judge
Observability	Tracing with Langfuse, Logfire, Arize, The Context Company, and 12+ providers
Scheduler	Run agents, teams, and workflows on recurring schedules

Components

A primitive + capabilities + configuration becomes a live component of your agent platform.

You can create components in code, through a no-code UI, or via the AgentOS API. Change code-defined components in Python. Components created via the API or no-code UI have draft and published configuration versions that you can promote or roll back. The /components API lets you build, version, and operate components over HTTP.

Versioned components

When components are created via the API, they carry a versioned configuration. Published versions are immutable, and run requests accept a version parameter so you can pin clients to a specific version. A current pointer decides which version your production API serves: set it to a newer version to promote, or an earlier one to roll back.

Tune a component’s instructions, model, or tools and publish the change as a new version. Promote the new version or roll back to an earlier version based on its results.

Learn more

SDK Introduction

Agents, teams, and workflows in pure Python.

Build Agents

Create agents with models, tools, and instructions.

Build Agent Platform

Assemble a full platform on the AgentOS runtime.