agno — エージェントフレームワーク

agnoとは

Agnoは3つの層でできています。エージェント・チーム・ワークフローを書くPython製のSDK、それらをREST APIとして公開し、セッション、JWTによる権限確認、定期実行、実行記録の保存までを自前のデータベースで賄うFastAPI製のランタイムAgentOS、そして実行の様子を眺めるための管理画面です。前の2つはApache-2.0で、コンテナが動く場所ならどこでも動かせます。既定で送られる利用統計を除けば、処理もデータもAgnoのサーバーを通りません。例外は管理画面で、手元のランタイムにつなぐ分は無料ですが、デプロイ済みのランタイムにつなぐには有料プランが要ります。開発の速度が速く、マイナー更新の多くに破壊的変更が入るため、バージョンを固定してから作り込むのが安全です。

agnoで何ができますか？

モデルとツールと指示、その3つでエージェントになります — 20行ほどで動くエージェントが書けます。使うモデルを選び、作業フォルダの読み書きやWeb検索といったツールを渡し、振る舞いを普通の文章で指示するだけです。応答は逐次表示されるので、言い回しを直しながら試せます。
データベースをつなぐと会話が残ります — データベースを設定するとセッションが有効になり、実行がセッションIDでまとまって利用者IDと結び付きます。過去のやり取りを次のリクエストに差し戻せるほか、メモリ機能は利用者ごとの好みや目標を抜き出して、別の会話でも思い出します。
検索するかどうかをエージェントが決めるナレッジベース — ファイルやURL、テキストをナレッジベースに取り込み、ベクトルデータベースに保存します。LanceDBやChromaDBのように手元で動くものから、PineconeやWeaviateのような管理型まで選べます。既定では毎回文脈を差し込むのではなく、必要だと判断したときにエージェント自身が検索します。ドキュメントでAgentic RAGと呼ばれている動作で、気付いたことを書き戻させることもできます。
チームは委任、ワークフローは決められた道筋 — チームではリーダーが役割の違うメンバーへ仕事を振り分け、結果をまとめます。ワークフローはその逆で、順番・条件分岐・繰り返し・並列を書いた固定の手順です。リーダーとメンバーが別々にモデルを呼ぶため待ち時間もトークンも増える、1つの専門分野で済む仕事なら単一のエージェントにすべきだ、と公式ドキュメント自身が書いています。
書いたエージェントをそのままサービスにするAgentOS — AgentOSに載せるとFastAPIのアプリになり、エージェントやチームごとの実行エンドポイント、逐次配信、JWTによる権限確認、同じプロセス内で動く定期実行、自前のデータベースへの実行記録が付いてきます。管理者の承認が要るツールの手前で実行を止めて人の確認を待つこともでき、SlackやTelegram、WhatsAppへの接続も設定ひとつです。
ツールを増やしすぎないためのContext Providers — SlackやGoogleドライブ、データベースといった外部システムを、読み取り用と書き込み用のツールに集約します。公式ドキュメントによればSlackだけでツールは8〜12個になり、20を超えるとモデルが選び間違えはじめます。実際の呼び出しは各システム専用の小さな子エージェントが担当し、呼び出し元は判断に専念します。

agnoを選ぶ前に

SDKとAgentOSはApache-2.0ですが、管理画面はAgnoのホスト型製品で、2026年8月時点では手元のAgentOSにつなぐ分は無料、デプロイ済みのものにつなぐと月150ドル、自前運用はEnterprise契約のみです。
v1からv2はデータベースの移行スクリプトが必要で、v2.9.0までのマイナー更新は10回のうち8回が破壊的変更を含み、2026年8月にはv3のアルファ版が出ているため、更新の負担は軽くありません。

スター推移

8月17日〜8月28日 · +213

41.7k42k

よくある質問

agnoは商用利用できますか?

agnoはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

agnoはどの形で使えますか?

agnoはセルフホスト・ローカル実行の形で利用できます。

ドキュメント

agno-agi/agno のREADMEより転載（Apache-2.0）。原文を読む ↗

Introduction

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

Build your agent platform using the Agno SDK.
Run your agent platform using the AgentOS runtime.
Manage everything using the AgentOS 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.

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

Production API. 50+ endpoints with SSE and websockets to build a product on top.
Storage. Store sessions, memory, knowledge, and traces in your own database.
100+ integrations. Connect to GitHub, Slack, Postgres, and more using pre-built toolkits.
Context Providers. Access live data from Slack, Drive, wikis, MCP, and custom sources.
Human approval. Pause runs for user confirmation. Block tools that require admin approval.
Observability. Monitor with OpenTelemetry tracing, run history, and audit logs.
Security. Get JWT-based RBAC and multi-user, multi-tenant isolation out of the box.
Interfaces. Expose your agents via Slack, Telegram, WhatsApp, Discord, AG-UI, A2A.
Scheduling. Cron-based scheduling and background jobs with no external infrastructure.
Deploy anywhere. Run on any cloud platform that runs containers. Docker, Railway, AWS, GCP.

Use Agno with your coding agent

Two options:

Recommended: Add Agno docs as an MCP server. Add docs.agno.com/mcp to your favourite coding agent.
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

X: follow for releases and demos
Newsletter: monthly updates on what’s shipping

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.