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
这是什么东西?Agno 是一个用于构建、运行和管理智能体平台的框架和运行时:用 SDK 构建智能体,通过 AgentOS 运行时对外提供服务,再用网页界面统一管理。
Agno 是框架、服务器,还是托管应用?两部分都有:一个是用于构建智能体的 Python SDK,另一个是 AgentOS——一个可自行部署的运行时,能把智能体作为服务对外提供,自带 REST API、控制面板和网页界面。
我怎么把第一个平台跑起来?把快速上手的提示词交给 Claude Code、Cursor 或 Codex 这类编程智能体:它会用 Docker 在本地把整套服务拉起来——REST API、Postgres、MCP 服务器、控制面板。你也可以自己动手,用 20 行代码写出第一个智能体。
这需要 Docker 和编程智能体吗?本地运行需要 Docker,存储用 Postgres;编程智能体是可选的,因为 README 里也演示了如何手动用 20 行代码写出第一个智能体。
跑通之后能部署到哪里?任何能跑容器的地方都行:本地用 Docker,另外还提供了 Railway、AWS、GCP、Azure、Fly、Render、Modal 和 Helm 的入门模板——只是部署脚本不一样。
它会把我的数据发回去吗?每次运行智能体只上报一条遥测事件,让团队知道该优先支持哪些模型提供商;提示词、消息和输出内容都不会发送,而且可以通过设置 AGNOTELEMETRY=false 把它关掉。
AgentOS 开箱即用能给我什么?一个可用于生产环境的 REST API,包含 50 多个端点(支持 SSE 和 websocket);会话、记忆、知识和追踪记录都存在你自己的数据库里;还有一个 MCP 服务器;基于 JWT 的 RBAC 权限控制,支持多租户隔离;基于 OpenTelemetry 的追踪,带运行历史和审计日志;还有基于 cron 的定时任务和后台作业,不需要额外的基础设施。另外还有 100 多个现成的工具包集成,比如 GitHub、Slack 和 Postgres。
用户可以在哪里和我的智能体对话?开箱即用,你的智能体可以通过 Slack、Telegram、WhatsApp、Discord 以及 AG-UI 和 A2A 接口对外提供服务,这些聊天集成不用你自己开发。
它怎么防止智能体做出危险操作?在执行敏感步骤之前,运行可以暂停下来等待人工批准;也可以把某些工具单独设为受限,执行前必须由管理员确认。
为什么要自己掌控整个智能体技术栈,而不是用托管服务?README 的说法是:用基于 JWT 的 RBAC 把数据、记忆和安全策略掌握在自己手里,所有内容都存在你自己的数据库里,再借助模拟测试和使用数据,把平台变成一个不断学习的闭环。
Creator
agno-agi
Size
321.1 MB
Stars
42.8K
Age
4y
Commits · 90 Days