ag-ui – ag-ui-protocol

<img src="https://github.com/user-attachments/assets/ebc0dd08-8732-4519-9b6c-452ce54d8058" alt="ag-ui Logo" width="22"/> 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.

<br>

<img src="https://img.shields.io/npm/v/@ag-ui/core?label=Version&color=6963ff&logo=npm&logoColor=white" alt="Version" class="ra0-md-img" loading="lazy" />

<a href="https://discord.gg/Jd3FzfdJa8" target="_blank"> Join our Discord → </a> &nbsp;&nbsp;&nbsp; <a href="https://ag-ui.com/" target="_blank"> Read the Docs → </a> &nbsp;&nbsp;&nbsp; <a href="https://dojo.ag-ui.com/" target="_blank"> Go to the AG-UI Dojo → </a> &nbsp;&nbsp;&nbsp; <a href="https://x.com/CopilotKit" target="_blank"> Follow us → </a>

<img width="1600" height="680" alt="1600x680" src="https://github.com/user-attachments/assets/00ec7366-713e-443f-a8f0-8db52ad28ef4" />

🚀 Getting Started

Create a new AG-UI application in seconds:

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

<h3> Useful Links:</h3>

• The AG-UI Dojo
• Build AG-UI-powered applications(Quickstart)
• Build new AG-UI framework integrations (Quickstart)
• Book a call to discuss an AG-UI integration with a new framework
• Join the Discord Community

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

<div align="center">
<img width="2048" height="1182" alt="The Agent Protocol Stack" src="https://github.com/user-attachments/assets/41138f71-50be-4812-98aa-20e0ad595716" />
</div>

🚀 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

🤝 Partnerships

🧩 1st Party

🌐 Community

Agent Interaction Protocols

Infrastructure / Deployment

Specification (standard)

Generative UI

SDKs

Clients

View all supported integrations →

Examples

Hello World App

Video:

https://github.com/user-attachments/assets/18c03330-1ebc-4863-b2b8-cc6c3a4c7bae

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.

https://github.com/user-attachments/assets/c298eea8-3f39-4a94-b968-7712429b0c49

🙋🏽‍♂️ Contributing to AG-UI

Check out the Contributing guide

• Bi-Weekely AG-UI Working Group*

📅 Follow the CopilotKit Luma Events Calendar

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.