From ffe020494170d6f41dfb96f2a1c341d2524bf4ba Mon Sep 17 00:00:00 2001 From: shaloo Date: Wed, 4 Feb 2026 19:26:48 +0530 Subject: [PATCH 1/5] Update and clean up, refine and reorganize, scaffold to add builder info in the coming iterations --- agent-os/introduction.mdx | 141 +++++++++++++++++++++++++------------- docs.json | 15 ++-- 2 files changed, 105 insertions(+), 51 deletions(-) diff --git a/agent-os/introduction.mdx b/agent-os/introduction.mdx index ac4e9ec53..d85a847a7 100644 --- a/agent-os/introduction.mdx +++ b/agent-os/introduction.mdx @@ -1,20 +1,29 @@ --- title: "What is AgentOS?" sidebarTitle: "Introduction" -description: "The runtime and control plane for multi-agent systems." +description: "The runtime, visual builder and control plane for multi-agent systems." --- -**AgentOS turns your agents into a production API you can deploy anywhere.** It gives you a pre-built backend for your AI product, so all you need to do is add your agent logic, build your frontend and your product is live. +**AgentOS turns your Agno SDK agents into a production API ready to deploy anywhere.** +It gives you a FastAPI-based backend for your AI product, so all you need to do is add your agent logic, +build your frontend and your product is live. -You bring the agents and AgentOS turns it into a product: -- 50+ API endpoints with SSE-compatible streaming. Ready for production on day one. -- Sessions, memory, knowledge stored in your database. Your data stays in your system. -- Request-level isolation. No state bleed between users, agents and sessions. -- JWT-based RBAC with hierarchical scopes. Enterprise-ready from day one. -- Tracing built-in, stored in your database. No third-party egress. No vendor lock-in. -- Guardrails, human in the loop, learning machines. The full Agno framework. + +Fully Compatible with the FastAPI Ecosystem. +AgentOS exposes the underlying FastAPI instance, allowing you to deploy custom routes, background workers, and middleware +with zero additional configuration. + + +AgentOS comprises of two parts: +1. **Runtime**: To run your Agno agents built using the Agno SDK +2. **User interface**: Visual agent builder and [control plane](/agent-os/control-plane) that lets you build, monitor, debug and deploy your agents -Here's an example of an AgentOS serving an Agent with memory, state, and MCP tools: +To use AgentOS, first instantiate and [run it](/agent-os/run-your-os) and then [connect it to the user interface](/agent-os/connect-your-os). + + + + +This is a basic AgentOS instance serving an Agent with memory, state, and MCP tools. You can monitor this agent after connecting the AgentOS to the UI. ```python agno_agent.py from agno.os import AgentOS @@ -36,29 +45,75 @@ app = agent_os.get_app() if __name__ == "__main__": agent_os.serve(app="agno_agent:app", reload=True) ``` + + +You can create an AgentOS instance with pre-registered components (agents, teams, workflows, tools, database, etc.). +When you connect this AgentOS to the UI, you view and use these components in the visual editor as draggable nodes for complex system design. + +```python agent_os_registry.py +from agno.agent.agent import Agent +from agno.db.postgres import PostgresDb +from agno.models.anthropic import Claude +from agno.models.openai import OpenAIChat +from agno.os import AgentOS +from agno.registry import Registry +from agno.tools.calculator import CalculatorTools +from agno.tools.duckduckgo import DuckDuckGoTools - +db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai", id="postgres_db") -AgentOS runs on FastAPI. Add middleware, custom routes, background tasks, or any FastAPI feature without extra configuration. - +def sample_tool(): + return "Hello, world!" -## Control Plane -AgentOS comes with a built-in [control plane](https://os.agno.com) that connects directly to your runtime from your browser. Monitor sessions. Debug with full traces. Manage users and permissions. +registry = Registry( + name="Agno Registry", + tools=[DuckDuckGoTools(), sample_tool, CalculatorTools()], + models=[ + OpenAIChat(id="gpt-5-mini"), + OpenAIChat(id="gpt-5"), + Claude(id="claude-sonnet-4-5"), + ], + dbs=[db], +) - - - +agent = Agent( + id="registry-agent", + model=Claude(id="claude-sonnet-4-5"), + db=db, +) + +agent_os = AgentOS( + agents=[agent], + id="registry-agent-os", + registry=registry, + db=db, +) + +app = agent_os.get_app() + +if __name__ == "__main__": + agent_os.serve(app="agent_os_registry:app", reload=True) +``` + + + +## Architecture + +Your AgentOS runs as a container in your cloud. The control plane connects directly from your browser. No proxy servers, no data relay. + +AgentOS Architecture + +AgentOS Architecture ## Private by Design @@ -79,23 +134,17 @@ See [AgentOS Security](/agent-os/security) for more details. /> -## Architecture - -Your AgentOS runs as a container in your cloud. The control plane connects directly from your browser. No proxy servers, no data relay. +## AgentOS Features and Benefits -AgentOS Architecture - -AgentOS Architecture +You bring in your agents and AgentOS turns them into a production-ready agentic system: +- 50+ API endpoints with SSE-compatible streaming. Ready for production on day one. +- Sessions, memory, knowledge stored in your database. Your data stays in your system. +- Request-level isolation. No state bleed between users, agents and sessions. +- JWT-based RBAC with hierarchical scopes. Enterprise-ready from day one. +- Tracing built-in, stored in your database. No third-party egress. No vendor lock-in. +- Guardrails, human in the loop, learning machines. The full Agno framework. -## Get Started +## Next Steps - Connect your AgentOS to the UI + Connect your AgentOS to the Control Plane and Builder UI Monitor and manage your AgentOS - + diff --git a/docs.json b/docs.json index ce4144e31..e6c2a9694 100644 --- a/docs.json +++ b/docs.json @@ -2757,9 +2757,14 @@ "group": "Get Started", "pages": [ "agent-os/introduction", - "agent-os/run-your-os", - "agent-os/connect-your-os", - "agent-os/control-plane", + { + "group": "Usage", + "pages": [ + "agent-os/run-your-os", + "agent-os/connect-your-os", + "agent-os/control-plane" + ] + }, { "group": "Security & Authorization", "pages": [ @@ -2770,7 +2775,7 @@ ] }, { - "group": "AgentOS", + "group": "Basic", "pages": [ "agent-os/overview", "agent-os/using-the-api", @@ -2857,7 +2862,7 @@ ] }, { - "group": "Example Usage", + "group": "Advanced", "pages": [ "agent-os/usage/demo", "agent-os/usage/extra-configuration", From 594a58ed92248592af2a49217916337bf760dcf8 Mon Sep 17 00:00:00 2001 From: shaloo Date: Thu, 5 Feb 2026 16:16:00 +0530 Subject: [PATCH 2/5] wip -repo renamed --- agent-os/introduction.mdx | 7 +++- agent-os/overview.mdx | 73 +++++++++++++++++++++++---------------- 2 files changed, 50 insertions(+), 30 deletions(-) diff --git a/agent-os/introduction.mdx b/agent-os/introduction.mdx index d85a847a7..299247b1f 100644 --- a/agent-os/introduction.mdx +++ b/agent-os/introduction.mdx @@ -20,6 +20,8 @@ AgentOS comprises of two parts: To use AgentOS, first instantiate and [run it](/agent-os/run-your-os) and then [connect it to the user interface](/agent-os/connect-your-os). +## Create AgentOS + @@ -101,7 +103,10 @@ if __name__ == "__main__": ## Architecture -Your AgentOS runs as a container in your cloud. The control plane connects directly from your browser. No proxy servers, no data relay. +Your AgentOS runs as a container in your cloud. The AgentOS UI is the visual builder and control plane that +connects directly from your browser. + +No proxy servers, no data relay. Date: Wed, 4 Feb 2026 19:26:48 +0530 Subject: [PATCH 3/5] Update and clean up, refine and reorganize, scaffold to add builder info in the coming iterations --- agent-os/introduction.mdx | 141 +++++++++++++++++++++++++------------- docs.json | 15 ++-- 2 files changed, 105 insertions(+), 51 deletions(-) diff --git a/agent-os/introduction.mdx b/agent-os/introduction.mdx index ac4e9ec53..d85a847a7 100644 --- a/agent-os/introduction.mdx +++ b/agent-os/introduction.mdx @@ -1,20 +1,29 @@ --- title: "What is AgentOS?" sidebarTitle: "Introduction" -description: "The runtime and control plane for multi-agent systems." +description: "The runtime, visual builder and control plane for multi-agent systems." --- -**AgentOS turns your agents into a production API you can deploy anywhere.** It gives you a pre-built backend for your AI product, so all you need to do is add your agent logic, build your frontend and your product is live. +**AgentOS turns your Agno SDK agents into a production API ready to deploy anywhere.** +It gives you a FastAPI-based backend for your AI product, so all you need to do is add your agent logic, +build your frontend and your product is live. -You bring the agents and AgentOS turns it into a product: -- 50+ API endpoints with SSE-compatible streaming. Ready for production on day one. -- Sessions, memory, knowledge stored in your database. Your data stays in your system. -- Request-level isolation. No state bleed between users, agents and sessions. -- JWT-based RBAC with hierarchical scopes. Enterprise-ready from day one. -- Tracing built-in, stored in your database. No third-party egress. No vendor lock-in. -- Guardrails, human in the loop, learning machines. The full Agno framework. + +Fully Compatible with the FastAPI Ecosystem. +AgentOS exposes the underlying FastAPI instance, allowing you to deploy custom routes, background workers, and middleware +with zero additional configuration. + + +AgentOS comprises of two parts: +1. **Runtime**: To run your Agno agents built using the Agno SDK +2. **User interface**: Visual agent builder and [control plane](/agent-os/control-plane) that lets you build, monitor, debug and deploy your agents -Here's an example of an AgentOS serving an Agent with memory, state, and MCP tools: +To use AgentOS, first instantiate and [run it](/agent-os/run-your-os) and then [connect it to the user interface](/agent-os/connect-your-os). + + + + +This is a basic AgentOS instance serving an Agent with memory, state, and MCP tools. You can monitor this agent after connecting the AgentOS to the UI. ```python agno_agent.py from agno.os import AgentOS @@ -36,29 +45,75 @@ app = agent_os.get_app() if __name__ == "__main__": agent_os.serve(app="agno_agent:app", reload=True) ``` + + +You can create an AgentOS instance with pre-registered components (agents, teams, workflows, tools, database, etc.). +When you connect this AgentOS to the UI, you view and use these components in the visual editor as draggable nodes for complex system design. + +```python agent_os_registry.py +from agno.agent.agent import Agent +from agno.db.postgres import PostgresDb +from agno.models.anthropic import Claude +from agno.models.openai import OpenAIChat +from agno.os import AgentOS +from agno.registry import Registry +from agno.tools.calculator import CalculatorTools +from agno.tools.duckduckgo import DuckDuckGoTools - +db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai", id="postgres_db") -AgentOS runs on FastAPI. Add middleware, custom routes, background tasks, or any FastAPI feature without extra configuration. - +def sample_tool(): + return "Hello, world!" -## Control Plane -AgentOS comes with a built-in [control plane](https://os.agno.com) that connects directly to your runtime from your browser. Monitor sessions. Debug with full traces. Manage users and permissions. +registry = Registry( + name="Agno Registry", + tools=[DuckDuckGoTools(), sample_tool, CalculatorTools()], + models=[ + OpenAIChat(id="gpt-5-mini"), + OpenAIChat(id="gpt-5"), + Claude(id="claude-sonnet-4-5"), + ], + dbs=[db], +) - - - +agent = Agent( + id="registry-agent", + model=Claude(id="claude-sonnet-4-5"), + db=db, +) + +agent_os = AgentOS( + agents=[agent], + id="registry-agent-os", + registry=registry, + db=db, +) + +app = agent_os.get_app() + +if __name__ == "__main__": + agent_os.serve(app="agent_os_registry:app", reload=True) +``` + + + +## Architecture + +Your AgentOS runs as a container in your cloud. The control plane connects directly from your browser. No proxy servers, no data relay. + +AgentOS Architecture + +AgentOS Architecture ## Private by Design @@ -79,23 +134,17 @@ See [AgentOS Security](/agent-os/security) for more details. /> -## Architecture - -Your AgentOS runs as a container in your cloud. The control plane connects directly from your browser. No proxy servers, no data relay. +## AgentOS Features and Benefits -AgentOS Architecture - -AgentOS Architecture +You bring in your agents and AgentOS turns them into a production-ready agentic system: +- 50+ API endpoints with SSE-compatible streaming. Ready for production on day one. +- Sessions, memory, knowledge stored in your database. Your data stays in your system. +- Request-level isolation. No state bleed between users, agents and sessions. +- JWT-based RBAC with hierarchical scopes. Enterprise-ready from day one. +- Tracing built-in, stored in your database. No third-party egress. No vendor lock-in. +- Guardrails, human in the loop, learning machines. The full Agno framework. -## Get Started +## Next Steps - Connect your AgentOS to the UI + Connect your AgentOS to the Control Plane and Builder UI Monitor and manage your AgentOS - + diff --git a/docs.json b/docs.json index 3f69712df..0b5ec02e6 100644 --- a/docs.json +++ b/docs.json @@ -2757,9 +2757,14 @@ "group": "Get Started", "pages": [ "agent-os/introduction", - "agent-os/run-your-os", - "agent-os/connect-your-os", - "agent-os/control-plane", + { + "group": "Usage", + "pages": [ + "agent-os/run-your-os", + "agent-os/connect-your-os", + "agent-os/control-plane" + ] + }, { "group": "Security & Authorization", "pages": [ @@ -2770,7 +2775,7 @@ ] }, { - "group": "AgentOS", + "group": "Basic", "pages": [ "agent-os/overview", "agent-os/using-the-api", @@ -2873,7 +2878,7 @@ ] }, { - "group": "Example Usage", + "group": "Advanced", "pages": [ "agent-os/usage/demo", "agent-os/usage/extra-configuration", From 6a2c2bcb384f33352c9739253df958584e29e04a Mon Sep 17 00:00:00 2001 From: shaloo Date: Thu, 5 Feb 2026 16:16:00 +0530 Subject: [PATCH 4/5] wip -repo renamed --- agent-os/introduction.mdx | 7 +++- agent-os/overview.mdx | 73 +++++++++++++++++++++++---------------- 2 files changed, 50 insertions(+), 30 deletions(-) diff --git a/agent-os/introduction.mdx b/agent-os/introduction.mdx index d85a847a7..299247b1f 100644 --- a/agent-os/introduction.mdx +++ b/agent-os/introduction.mdx @@ -20,6 +20,8 @@ AgentOS comprises of two parts: To use AgentOS, first instantiate and [run it](/agent-os/run-your-os) and then [connect it to the user interface](/agent-os/connect-your-os). +## Create AgentOS + @@ -101,7 +103,10 @@ if __name__ == "__main__": ## Architecture -Your AgentOS runs as a container in your cloud. The control plane connects directly from your browser. No proxy servers, no data relay. +Your AgentOS runs as a container in your cloud. The AgentOS UI is the visual builder and control plane that +connects directly from your browser. + +No proxy servers, no data relay. Date: Thu, 5 Feb 2026 20:31:27 +0530 Subject: [PATCH 5/5] Factor in Ashpreet's feedback --- agent-os/introduction.mdx | 49 +++++++++++++----------------------- agent-os/overview.mdx | 53 +++++++++++++++++++++++++++++++++------ agent-os/run-your-os.mdx | 35 +++++++++++--------------- 3 files changed, 78 insertions(+), 59 deletions(-) diff --git a/agent-os/introduction.mdx b/agent-os/introduction.mdx index 299247b1f..1394229da 100644 --- a/agent-os/introduction.mdx +++ b/agent-os/introduction.mdx @@ -4,22 +4,14 @@ sidebarTitle: "Introduction" description: "The runtime, visual builder and control plane for multi-agent systems." --- -**AgentOS turns your Agno SDK agents into a production API ready to deploy anywhere.** -It gives you a FastAPI-based backend for your AI product, so all you need to do is add your agent logic, -build your frontend and your product is live. - - -Fully Compatible with the FastAPI Ecosystem. -AgentOS exposes the underlying FastAPI instance, allowing you to deploy custom routes, background workers, and middleware -with zero additional configuration. - +**AgentOS turns your agents into a production API ready to deploy anywhere.** +All you need to do is add your agent logic, build your frontend and your product is live. AgentOS comprises of two parts: + 1. **Runtime**: To run your Agno agents built using the Agno SDK 2. **User interface**: Visual agent builder and [control plane](/agent-os/control-plane) that lets you build, monitor, debug and deploy your agents -To use AgentOS, first instantiate and [run it](/agent-os/run-your-os) and then [connect it to the user interface](/agent-os/connect-your-os). - ## Create AgentOS @@ -47,6 +39,7 @@ app = agent_os.get_app() if __name__ == "__main__": agent_os.serve(app="agno_agent:app", reload=True) ``` + You can create an AgentOS instance with pre-registered components (agents, teams, workflows, tools, database, etc.). @@ -98,16 +91,20 @@ app = agent_os.get_app() if __name__ == "__main__": agent_os.serve(app="agent_os_registry:app", reload=True) ``` + ## Architecture -Your AgentOS runs as a container in your cloud. The AgentOS UI is the visual builder and control plane that -connects directly from your browser. +Your AgentOS runs as a container in your cloud. The AgentOS UI is the visual builder and control plane that +connects directly from your browser. No proxy servers, no data relay. +Fully Compatible with the FastAPI Ecosystem. Deploy custom routes, background workers, and middleware +with zero additional configuration. + - + Create and run your first AgentOS - Connect your AgentOS to the Control Plane and Builder UI + Connect your AgentOS to the Control Plane and Builder UI - + Monitor and manage your AgentOS - - + + Learn more about AgentOS - \ No newline at end of file + diff --git a/agent-os/overview.mdx b/agent-os/overview.mdx index 4e296d080..4dcdeb0ce 100644 --- a/agent-os/overview.mdx +++ b/agent-os/overview.mdx @@ -3,10 +3,7 @@ title: "Overview" description: "Create and configure your AgentOS instance" --- -AgentOS turns your Agno agents into a production API. You must first create an AgentOS instance -with the requisite configuration, [run it](/agent-os/run-your-os) and then [connect it to the user interface](/agent-os/connect-your-os). - -## Create AgentOS +AgentOS turns your Agno agents into a production API. A minimal AgentOS application looks like this: @@ -27,14 +24,54 @@ if __name__ == "__main__": agent_os.serve(app="my_os:app", reload=True) ``` +Next, [run it](/agent-os/run-your-os) and then [connect it to AgentOS UI](/agent-os/connect-your-os). + ## AgentOS UI -Create and run your AgentOS. Then connect to the AgentOS UI to interact with your agents. The UI offers visual builder called Studio and the AgentOS control plane to monitor, debug and manage your Agno agents. +AgentOS UI comprises of: -The control plane displays all the Agno agents and workflows created programmatically or via APIs in the AgentOS runtime. You can drag and drop Agno components in the builder canvas to create your agentic system. Only the registered agents, teams, workflows, knowledge bases, tools, etc. will be visible as components in the builder UI available for drag and drop use via the UI. To register Agno components, you can pass them as parameters to the AgentOS constructor or use the `register` method of the AgentOS instance. +1. **Studio**: Visual agent builder to design your agentic systems. +2. **Control Plane**: To monitor, debug and manage your Agno agents. -```python -agent_os.register(agents=[my_agent], teams=[my_team], workflows=[my_workflow], knowledge=[my_knowledge], tools=[my_tools]) +Create agents programmatically via the Agno SDK/APIs or the visual builder. + +The control plane displays runtime agents and workflows. Use the builder canvas to visually design systems by dragging and dropping components. To make components visible in the builder UI, register them via the `AgentOS` constructor. + +```python agent_os_registry.py +from agno.db.postgres import PostgresDb +from agno.models.openai import OpenAIChat +from agno.models.anthropic import Claude +from agno.os import AgentOS +from agno.registry import Registry +from agno.tools.calculator import CalculatorTools +from agno.tools.websearch import WebSearchTools +from agno.vectordb.pgvector import PgVector +from pydantic import BaseModel + +class InputSchema(BaseModel): + input: str + description: str + +def custom_evaluator(input: str) -> bool: + return "urgent" in input.lower() + +db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai", id="postgres_db") + +registry = Registry( + name="My Registry", + tools=[CalculatorTools(), WebSearchTools()], + models=[OpenAIChat(id="gpt-5-mini"), Claude(id="claude-sonnet-4-5")], + dbs=[db], + vector_dbs=[PgVector(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai", table_name="embeddings")], + schemas=[InputSchema], + functions=[custom_evaluator], +) + +agent_os = AgentOS(id="my-app", registry=registry, db=db) +app = agent_os.get_app() + +if __name__ == "__main__": + agent_os.serve(app="agent_os_registry:app", reload=True) ``` ## Parameters diff --git a/agent-os/run-your-os.mdx b/agent-os/run-your-os.mdx index 59a981ce1..d76be8b52 100644 --- a/agent-os/run-your-os.mdx +++ b/agent-os/run-your-os.mdx @@ -4,6 +4,7 @@ description: "Run a local AgentOS in 20 lines of code." --- Save the following code to `agno_agent.py`: + ```python agno_agent.py lines from agno.os import AgentOS from agno.agent import Agent @@ -47,22 +48,16 @@ uv venv --python 3.12 - -```bash -uv pip install -U agno anthropic 'fastapi[standard]' sqlalchemy -``` - + + ```bash uv pip install -U agno anthropic 'fastapi[standard]' sqlalchemy ``` + - - -```bash Mac -export ANTHROPIC_API_KEY=sk-*** -``` -```bash Windows -setx ANTHROPIC_API_KEY sk-*** -``` - - + + + ```bash Mac export ANTHROPIC_API_KEY=sk-*** ``` ```bash Windows setx + ANTHROPIC_API_KEY sk-*** ``` + + ```bash @@ -73,8 +68,8 @@ fastapi dev agno_agent.py Your AgentOS is now running at `http://localhost:8000`. -| Endpoint | Description | -|----------|-------------| -| `http://localhost:8000` | Connect to the control plane | -| `http://localhost:8000/docs` | Interactive API documentation | -| `http://localhost:8000/config` | View AgentOS configuration | +| Endpoint | Description | +| ------------------------------ | ----------------------------- | +| `http://localhost:8000` | Connect to the control plane | +| `http://localhost:8000/docs` | Interactive API documentation | +| `http://localhost:8000/config` | View AgentOS configuration |