Agent SDK

Build agents, teams, and workflows in Python with composable models, tools, memory, knowledge, and guardrails.

The Agno SDK gives engineering teams Python primitives for agents, multi-agent teams, and explicit workflows, plus composable models, tools, memory, knowledge, learning, and guardrails. Each configured primitive remains a regular Python object that can run directly or be served through AgentOS.

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.")

workbench is a component: an agent primitive configured with a model, tools, storage, and session history. AgentOS serves the same object as a runtime component.

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	Continue long-running work after the initial API request returns
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

Agents, teams, and workflows become runnable components once you add their models, tools, state, and configuration. Code-defined components stay in Python. Components created in Studio or through the /components API use draft and published versions, with a current version that you can promote or roll back.

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.