Skip to content

ag-ui-protocol/ag-ui

Repository files navigation

ag-ui Logo AG-UI: The Agent-User Interaction Protocol

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 โ†’

Your application-AG-UI protocol

๐Ÿš€ 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
Direct to LLM โœ… 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
Mastra โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
Pydantic AI โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
Agno โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
LlamaIndex โœ… Supported โžก๏ธ Docs ๐ŸŽฎ Demos
AG2 โœ… Supported โžก๏ธ Docs
AWS Bedrock Agents ๐Ÿ› ๏ธ In Progress โ€“
AWS Strands Agents ๐Ÿ› ๏ธ In Progress โ€“

๐ŸŒ Community

Framework Status AG-UI Resources
Vercel AI SDK โœ… Supported โžก๏ธ Docs
OpenAI Agent SDK ๐Ÿ› ๏ธ In Progress โ€“
Cloudflare Agents ๐Ÿ› ๏ธ In Progress โ€“

Agent Interaction Protocols

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

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
.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.

About

AG-UI: the Agent-User Interaction Protocol. Bring Agents into Frontend Applications.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 55