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

# Remote Team

> Execute teams hosted on a remote AgentOS instance

**1. Create a Python file**

```python remote_team.py theme={null}
import asyncio

from agno.team import RemoteTeam


async def remote_team_example():
    """Call a remote team hosted on another AgentOS instance."""
    team = RemoteTeam(
        base_url="http://localhost:7777",
        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 team."""
    team = RemoteTeam(
        base_url="http://localhost:7777",
        team_id="research-team",
    )

    async for chunk in team.arun(
        "Tell me about Python programming",
        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("RemoteTeam Examples")
    print("=" * 60)

    print("\n1. Remote Team Example:")
    asyncio.run(remote_team_example())

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

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

**2. Install dependencies**

```bash theme={null}
uv pip install -U agno openai
```

**3. Export your OpenAI API key**

```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"
```

**4. Start an AgentOS Server**

Make sure you have an AgentOS server running with a team that has `id="research-team"`. See [Run Your AgentOS](https://agno-v2.mintlify.site/agent-os/run-your-os.md) for setup instructions.

**5. Run the Client**

```bash Mac theme={null}
python remote_team.py
```

```bash Windows theme={null}
python remote_team.py
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.