Remote Agent

1

Create a Python file

remote_agent.py

import asyncio

from agno.agent import RemoteAgent


async def remote_agent_example():
    """Call a remote agent hosted on another AgentOS instance."""
    agent = RemoteAgent(
        base_url="http://localhost:7777",
        agent_id="assistant-agent",
    )

    response = await agent.arun(
        "What is the capital of France?",
        user_id="user-123",
        session_id="session-456",
    )
    print(response.content)


async def remote_streaming_example():
    """Stream responses from a remote agent."""
    agent = RemoteAgent(
        base_url="http://localhost:7777",
        agent_id="assistant-agent",
    )

    async for chunk in agent.arun(
        "Tell me a short story about a brave knight",
        session_id="session-456",
        user_id="user-123",
        stream=True,
    ):
        if hasattr(chunk, "content") and chunk.content:
            print(chunk.content, end="", flush=True)


if __name__ == "__main__":
    print("=" * 60)
    print("RemoteAgent Examples")
    print("=" * 60)

    print("\n1. Remote Agent Example:")
    asyncio.run(remote_agent_example())

    print("\n\n2. Remote Streaming Example:")
    asyncio.run(remote_streaming_example())

2

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

uv venv --python 3.12
.venv\Scripts\activate

3

Install dependencies

uv pip install -U agno openai

4

Export your OpenAI API key

export OPENAI_API_KEY="your_openai_api_key_here"

$Env:OPENAI_API_KEY="your_openai_api_key_here"

5

Start an AgentOS Server

Make sure you have an AgentOS server running with an agent that has id="assistant-agent". See Creating Your First OS for setup instructions.

6

Run the Client

python remote_agent.py

python remote_agent.py