GitHub - ag-ui-protocol/ag-ui: AG-UI: the Agent-User Interaction Protocol. Bring Agents into Frontend Applications.

AG-UI is an open, lightweight, event-based protocol that standardizes how AI agents connect to user-facing applications. Built for simplicity and flexibility, it enables seamless integration between AI agents, real time user context, and user interfaces.


Version MIT Discord

Join our Discord โ†’     Read the Docs โ†’     Go to the AG-UI Dojo โ†’     Follow us โ†’

1600x680

๐Ÿš€ Getting Started

Create a new AG-UI application in seconds:

npx create-ag-ui-app my-agent-app

Useful Links:

What is AG-UI?

AG-UI is an open, lightweight, event-based protocol for agent-human interaction, designed for simplicity & flexibility:

  • During agent executions, agent backends emit events compatible with one of AG-UI's ~16 standard event types
  • Agent backends can accept one of a few simple AG-UI compatible inputs as arguments

AG-UI includes a flexible middleware layer that ensures compatibility across diverse environments:

  • Works with any event transport (SSE, WebSockets, webhooks, etc.)
  • Allows for loose event format matching, enabling broad agent and app interoperability

It also ships with a reference HTTP implementation and default connector to help teams get started fast.

Learn more about the specs โ†’

Why AG-UI?

AG-UI was developed based on real-world requirements and practical experience building in-app agent interactions.

Where does AGUI fit in the agentic protocol stack?

AG-UI is complementary to the other 2 top agentic protocols

  • MCP gives agents tools
  • A2A allows agents to communicate with other agents
  • AG-UI brings agents into user-facing applications

The Agent Protocol Stack

๐Ÿš€ Features

  • ๐Ÿ’ฌ Real-time agentic chat with streaming
  • ๐Ÿ”„ Bi-directional state synchronization
  • ๐Ÿงฉ Generative UI and structured messages
  • ๐Ÿง  Real-time context enrichment
  • ๐Ÿ› ๏ธ Frontend tool integration
  • ๐Ÿง‘โ€๐Ÿ’ป Human-in-the-loop collaboration

๐Ÿ›  Supported Integrations

AG-UI was born from CopilotKit's initial partnership with LangGraph and CrewAI - and brings the incredibly popular agent-user-interactivity infrastructure to the wider agentic ecosystem.

1st party = the platforms that have AGโ€‘UI built in and provide documentation for guidance.

Frameworks

Framework Status AG-UI Resources
Built-in Agent โœ… Supported โžก๏ธ Docs

๐Ÿค Partnerships

Framework Status AG-UI Resources
LangGraph โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
CrewAI โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos

๐Ÿงฉ 1st Party

Framework Status AG-UI Resources
Microsoft Agent Framework โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
Google ADK โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
AWS Strands Agents โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
Mastra โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
Pydantic AI โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
Agno โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
LlamaIndex โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
AG2 โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
AWS Bedrock Agents ๐Ÿ› ๏ธ In Progress โ€“

๐ŸŒ Community

Framework Status AG-UI Resources
OpenAI Agent SDK ๐Ÿ› ๏ธ In Progress โ€“
Cloudflare Agents ๐Ÿ› ๏ธ In Progress โ€“

Agent Interaction Protocols

Protocols Status AG-UI Resources Integrations
A2A โœ… Supported โžก๏ธ Docs Partnership

Specification (standard)

Framework Status AG-UI Resources
Oracle Agent Spec โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos

Generative UI

Framework Status AG-UI Resources
MCP Apps โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos

SDKs

SDK Status AG-UI Resources Integrations
Kotlin โœ… Supported โžก๏ธ Getting Started Community
Golang โœ… Supported โžก๏ธ Getting Started Community
Dart โœ… Supported โžก๏ธ Getting Started Community
Java โœ… Supported โžก๏ธ Getting Started Community
Rust โœ… Supported โžก๏ธ Getting Started Community
Ruby โœ… Supported โžก๏ธ Getting Started Community
.NET ๐Ÿ› ๏ธ In Progress โžก๏ธ PR Community
Nim ๐Ÿ› ๏ธ In Progress โžก๏ธ PR Community
Flowise ๐Ÿ› ๏ธ In Progress โžก๏ธ GitHub Source Community
Langflow ๐Ÿ› ๏ธ In Progress โžก๏ธ GitHub Source Community

Clients

Client Status AG-UI Resources Integrations
CopilotKit โœ… Supported โžก๏ธ Getting Started 1st Party
Terminal + Agent โœ… Supported โžก๏ธ Getting Started Community
React Native ๐Ÿ› ๏ธ Help Wanted โžก๏ธ GitHub Source Community

View all supported integrations โ†’

Examples

Hello World App

Video:

agui-hello-world-2.mp4

https://agui-demo.vercel.app/

The AG-UI Dojo (Building-Blocks Viewer)

The AG-UI Dojo demonstrates AG-UI's core building blocks through simple, focused examplesโ€”each just 50-200 lines of code.

View the source code for the Dojo and all framework integrations here.

dojo.mp4

๐Ÿ™‹๐Ÿฝโ€โ™‚๏ธ Contributing to AG-UI

Check out the Contributing guide

Roadmap

Check out the AG-UI Roadmap to see what's being built and where you can jump in.

๐Ÿ“„ License

AG-UI is open source software licensed as MIT.