agno README

The project's README from github.com/agno-agi/agno. As one markdown file: README.md.

Build, run, and manage agent platforms.

Introduction

Agno is a framework and runtime for agent platforms. Build agents, run them as a service, manage your platform using a web UI.

Agno allows you to own your agent stack. Maintain control of your data, memory, and security posture (JWT-based RBAC), and turn your agent platform into a learning loop with simulations and usage data.

demo-os

Get started

Hand this prompt to your coding agent (Claude Code, Cursor, Codex):

Help me set up my agent platform.

Clone https://github.com/agno-agi/agentos-railway into a folder called
agent-platform, cd in, read the README, and follow the get started guide.

Your coding agent will set up your agent platform and run it locally using Docker, giving you a REST API for serving your agents, a Postgres database for storing your data and traces, an MCP server, and a control plane.

Deploying somewhere else? Use the same prompt but point it to a different repo. The starter templates are identical except for the deploy scripts: swap agentos-railway for agentos-docker, agentos-aws, agentos-gcp, agentos-azure, agentos-fly, agentos-render, agentos-modal, or agentos-helm.

Prefer to code by hand?

Features

Use Agno with your coding agent

Two options:

  1. Recommended: Add Agno docs as an MCP server. Add docs.agno.com/mcp to your favourite coding agent.
  2. Add Agno docs as an indexed source. In Cursor: Settings → Indexing & Docs → Add https://docs.agno.com/llms-full.txt. Also works in VSCode, Windsurf, and similar tools.

Read the full guide here.

Community

Contributing

See the contributing guide.

License

Agno is distributed under the Apache-2.0 license.

Telemetry

Agno sends a telemetry event per agent run so we know which model providers to prioritize. Prompts, messages, and outputs are never sent. Disable by setting AGNO_TELEMETRY=false.

↑ Back to top

agno (agno-agi/agno)

Searching Database…

42.8K ·GitHub
What is this?Agno is a framework and runtime for building, running, and managing agent platforms: build agents with the SDK, serve them via the AgentOS runtime, and manage everything from a web UI.
Is Agno a framework, a server, or a hosted app?Both halves: a Python SDK for building agents, plus AgentOS — a self-hosted runtime that serves them as a service with a REST API, a control plane, and a web UI.
How do I get a first platform running?Hand the quickstart prompt to a coding agent like Claude Code, Cursor, or Codex: it spins up the stack locally via Docker — REST API, Postgres, MCP server, control plane. Or hand-code your first agent in 20 lines.
Do I need Docker and a coding agent for that?Docker for the local run and Postgres for storage; the coding agent is optional, since the README also shows building your first agent by hand in 20 lines of code.
Where can I deploy it once it works?Anywhere that runs containers: locally via Docker, with starter templates for Railway, AWS, GCP, Azure, Fly, Render, Modal, and Helm — only the deploy scripts differ.
Does it send any of my data home?One telemetry event per agent run, so the team knows which model providers to prioritize; prompts, messages, and outputs are never sent, and you can turn it off with the AGNOTELEMETRY=false setting.
What does AgentOS give me out of the box?A production REST API with 50+ endpoints (SSE and websockets), storage for sessions, memory, knowledge, and traces in your own database, an MCP server, JWT-based RBAC with multi-tenant isolation, OpenTelemetry tracing with run history and audit logs, and cron-based scheduling and background jobs with no extra infrastructure. There are also 100+ pre-built toolkit integrations like GitHub, Slack, and Postgres.
Where can users actually talk to my agents?Out of the box your agents can be exposed via Slack, Telegram, WhatsApp, Discord, and the AG-UI and A2A interfaces, so you don't have to build those chat integrations yourself.
How does it stop an agent from doing something risky?Runs can pause for human approval before sensitive steps, and individual tools can be blocked so they require admin confirmation before executing.
Why own the whole agent stack instead of using a hosted service?The README's pitch: keep control of your data, memory, and security posture with JWT-based RBAC, store everything in your own database, and turn the platform into a learning loop with simulations and usage data.
Creator
agno-agi
Size
321.1 MB
Stars
42.8K
Age
4y
Commits · 90 Days