Skip to main content

Agno: a lightweight library for building Multi-Agent Systems

Project description

Build, run, manage multi-agent systems.

Docs  •  Cookbook  •  Community  •  Discord

What is Agno?

Agno is a framework, runtime, and control plane for multi-agent systems.

Layer What it does
Framework Build agents, teams, and workflows with memory, knowledge, guardrails, and 100+ integrations
AgentOS Runtime Run your system in production with a stateless, secure FastAPI backend
Control Plane Test, monitor, and manage your system using the AgentOS UI

Why Agno?

  • Private by design. AgentOS runs in your cloud. The control plane connects directly to your runtime from your browser. No retention costs, no vendor lock-in, no compliance headaches.
  • Production-ready on day one. Pre-built FastAPI runtime with SSE endpoints, ready to deploy.
  • Fast. 529× faster instantiation than LangGraph. 24× lower memory. See benchmarks →

Example

An agent with MCP tools, persistent state, served via FastAPI:

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.os import AgentOS
from agno.tools.mcp import MCPTools

agno_agent = Agent(
    name="Agno Agent",
    model=Claude(id="claude-sonnet-4-5"),
    db=SqliteDb(db_file="agno.db"),
    tools=[MCPTools(transport="streamable-http", url="https://docs.agno.com/mcp")],
    add_history_to_context=True,
    markdown=True,
)

agent_os = AgentOS(agents=[agno_agent])
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="agno_agent:app", reload=True)

Run this and connect to the AgentOS UI:

https://github.com/user-attachments/assets/feb23db8-15cc-4e88-be7c-01a21a03ebf6

Features

Core

  • Model-agnostic: OpenAI, Anthropic, Google, local models
  • Type-safe I/O with input_schema and output_schema
  • Async-first, built for long-running tasks
  • Natively multimodal (text, images, audio, video, files)

Memory & Knowledge

  • Persistent storage for session history and state
  • User memory across sessions
  • Agentic RAG with 20+ vector stores, hybrid search, reranking
  • Culture: shared long-term memory across agents

Orchestration

  • Human-in-the-loop (confirmations, approvals, overrides)
  • Guardrails for validation and security
  • Pre/post hooks for the agent lifecycle
  • First-class MCP and A2A support
  • 100+ built-in toolkits

Production

  • Ready-to-use FastAPI runtime
  • Integrated control plane UI
  • Evals for accuracy, performance, latency
  • Durable execution for resumable workflows
  • RBAC and per-agent permissions

Getting Started

  1. Follow the quickstart guide
  2. Browse the cookbook for real-world examples
  3. Read the docs to go deeper

Performance

Agent workloads spawn hundreds of instances. Stateless, horizontal scalability isn't optional.

Metric Agno LangGraph PydanticAI CrewAI
Instantiation 3μs 1,587μs (529×) 170μs (57×) 210μs (70×)
Memory 6.6 KiB 161 KiB (24×) 29 KiB (4×) 66 KiB (10×)

Apple M4 MacBook Pro, Oct 2025. Run benchmarks yourself →

https://github.com/user-attachments/assets/54b98576-1859-4880-9f2d-15e1a426719d

IDE Integration

Add our docs to your AI-enabled editor:

Cursor: Settings → Indexing & Docs → Add https://docs.agno.com/llms-full.txt

Also works with VSCode, Windsurf, and similar tools.

Contributing

We welcome contributions. See the contributing guide.

Telemetry

Agno logs which model providers are used to prioritize updates. Disable with AGNO_TELEMETRY=false.

↑ Back to top

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agno-2.4.5.tar.gz (1.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agno-2.4.5-py3-none-any.whl (1.8 MB view details)

Uploaded Python 3

File details

Details for the file agno-2.4.5.tar.gz.

File metadata

  • Download URL: agno-2.4.5.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for agno-2.4.5.tar.gz
Algorithm Hash digest
SHA256 f8052103c761f038884c9929211cd705e32b557a1dd5457b805132f02b73beac
MD5 fbf68a4a09c557e0a3e4b9e1dd16325a
BLAKE2b-256 d087611d6e9c68720667e9af7be7c91b14916d151325a9bb09300b285f4ed899

See more details on using hashes here.

File details

Details for the file agno-2.4.5-py3-none-any.whl.

File metadata

  • Download URL: agno-2.4.5-py3-none-any.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for agno-2.4.5-py3-none-any.whl
Algorithm Hash digest
SHA256 97227aa723c4e35bc44eab59ad193a6b3d6fe6ea6f12324be8b6f1e76597e80e
MD5 aef5defbacb656c74730bc5aa84b4e91
BLAKE2b-256 c184ac52f32c8d7b55b62d573a08c3944c5cc4a7389364dbaaf5ed2bbf0f5b36

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page