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

# AG-UI

> Expose agents via the AG-UI protocol for frontend integration.

The AG-UI interface exposes any Agno agent or team via the [AG-UI protocol](https://docs.ag-ui.com/), enabling real-time streaming to compatible frontends like Dojo and CopilotKit.

## Quick Start

```python agui_agent.py theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.os.app import AgentOS
from agno.os.interfaces.agui import AGUI

agent = Agent(name="Assistant", model=OpenAIResponses(id="gpt-5.4"))

agent_os = AgentOS(
    agents=[agent],
    interfaces=[AGUI(agent=agent)],
)
app = agent_os.get_app()
```

```bash theme={null}
uv pip install 'agno[agui]'
python -m agno.os.serve agui_agent:app --port 9001
```

## How It Works

| Concept           | Behavior                                              |
| ----------------- | ----------------------------------------------------- |
| **Protocol**      | AG-UI standard for agent ↔ frontend communication     |
| **Streaming**     | Real-time token streaming with tool call visibility   |
| **Custom Events** | Stream structured data (charts, profiles) to frontend |
| **Frontends**     | Works with Dojo, CopilotKit, or any AG-UI client      |

## Setup

No external configuration required. Run the agent and connect your frontend to the `/agui` endpoint.

**Endpoint:** `http://localhost:9001/agui`

## Next Steps

<CardGroup cols={2}>
  <Card title="Full Guide" icon="book" href="/agent-os/interfaces/ag-ui/introduction">
    Custom events, state sync, and frontend integration.
  </Card>

  <Card title="Examples" icon="code" href="/agent-os/usage/interfaces/ag-ui/basic">
    Basic agent, tools, and team examples.
  </Card>

  <Card title="Cookbook" icon="github" href="https://github.com/agno-agi/agno/tree/main/cookbook/05_agent_os/interfaces/agui">
    Full runnable examples on GitHub.
  </Card>

  <Card title="AG-UI Protocol" icon="file-code" href="https://docs.ag-ui.com/">
    Official protocol specification.
  </Card>
</CardGroup>