> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-docs-audit-20260719-0149.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote Team

> Run a team hosted on another AgentOS with RemoteTeam, with and without streaming.

<Warning>
  This example docstring names removed `agent_os_setup.py` and `AgentOSRunner`. Start `server.py` in the generated Run step below; this example uses `RemoteTeam`.
</Warning>

```python remote_team.py theme={null}
"""
Examples demonstrating AgentOSRunner for remote execution.

Run `agent_os_setup.py` to start the remote AgentOS instance.
"""

import asyncio

from agno.team import RemoteTeam

# ---------------------------------------------------------------------------
# Create Example
# ---------------------------------------------------------------------------


async def remote_agent_example():
    """Call a remote agent hosted on another AgentOS instance."""
    # Create a runner that points to a remote agent
    team = RemoteTeam(
        base_url="http://localhost:7778",
        team_id="research-team",
    )

    response = await team.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."""
    team = RemoteTeam(
        base_url="http://localhost:7778",
        team_id="research-team",
    )

    async for chunk in team.arun(
        "Tell me a 2 sentence horror story",
        session_id="session-456",
        user_id="user-123",
        stream=True,
    ):
        if hasattr(chunk, "content") and chunk.content:
            print(chunk.content, end="", flush=True)


async def main():
    """Run all examples in a single event loop."""
    print("=" * 60)
    print("RemoteTeam Examples")
    print("=" * 60)

    # Run examples
    # Note: Remote examples require a running AgentOS instance

    print("\n1. Remote Team Example:")
    await remote_agent_example()

    print("\n2. Remote Streaming Example:")
    await remote_streaming_example()


# ---------------------------------------------------------------------------
# Run Example
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    asyncio.run(main())
```

## Run the Example

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U "agno[os]" chromadb ddgs openai
    ```
  </Step>

  <Step title="Export your API keys">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export OPENAI_API_KEY="your_openai_api_key_here"
      ```

      ```bash Windows theme={null}
      $Env:OPENAI_API_KEY="your_openai_api_key_here"
      ```
    </CodeGroup>
  </Step>

  <Step title="Clone Agno">
    Clone the repository and run the remaining commands from its root:

    ```bash theme={null}
    git clone --branch v2.7.4 --depth 1 https://github.com/agno-agi/agno.git
    cd agno
    ```
  </Step>

  <Step title="Start the remote AgentOS">
    In another terminal, start the [remote AgentOS server](/examples/agent-os/remote/server) on port 7778:

    ```bash theme={null}
    python cookbook/05_agent_os/remote/server.py
    ```
  </Step>

  <Step title="Run the example">
    Run the example from the repository root:

    ```bash theme={null}
    python cookbook/05_agent_os/remote/02_remote_team.py
    ```
  </Step>
</Steps>

Full source: [cookbook/05\_agent\_os/remote/02\_remote\_team.py](https://github.com/agno-agi/agno/blob/v2.7.4/cookbook/05_agent_os/remote/02_remote_team.py)