multiple_instances.py
Run the Example
1
Set up your virtual environment
2
Install dependencies
3
Export your OpenAI API key
4
Run the example
Save the code above as
multiple_instances.py, then run:Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Expose two agents from one AgentOS under independent AG-UI prefixes.
"""
Mount Multiple AG-UI Instances
==============================
Expose two agents from one AgentOS under independent AG-UI prefixes. Each
prefix receives its own POST /agui and GET /status routes.
Prerequisites: OPENAI_API_KEY
Run: .venvs/demo/bin/python cookbook/05_agent_os/16_agui/multiple_instances.py
Try: Compare POST /chat/agui with POST /analyst/agui on localhost:7777
"""
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS
from agno.os.interfaces.agui import AGUI
# ---------------------------------------------------------------------------
# Create Agents and Interface Mounts
# ---------------------------------------------------------------------------
db = SqliteDb(
id="agui-multiple-db",
db_file="tmp/agui_multiple.db",
)
chat_agent = Agent(
id="agui-chat-agent",
name="AG-UI Chat Agent",
model=OpenAIResponses(id="gpt-5.5"),
db=db,
instructions="Answer conversational questions in one or two sentences.",
)
analyst_agent = Agent(
id="agui-analyst-agent",
name="AG-UI Analyst Agent",
model=OpenAIResponses(id="gpt-5.5"),
db=db,
instructions="Answer with three labeled analytical points.",
)
agent_os = AgentOS(
id="agui-multiple-os",
description="Two independently addressable AG-UI interfaces.",
agents=[chat_agent, analyst_agent],
interfaces=[
AGUI(agent=chat_agent, prefix="/chat"),
AGUI(agent=analyst_agent, prefix="/analyst"),
],
)
app = agent_os.get_app()
# ---------------------------------------------------------------------------
# Run Multi-Interface Server
# ---------------------------------------------------------------------------
if __name__ == "__main__":
agent_os.serve(app=app)
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
Install dependencies
uv pip install -U "agno[agui,os]" openai
Export your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
Run the example
multiple_instances.py, then run:python multiple_instances.py
Was this page helpful?