ag-ui

ag-ui-protocol/ag-ui

The Agent-User Interaction Protocol

15k
Stars
1.3k
Forks
304
Open issues
86
Watchers
TypeScript MITLast pushed Jul 6, 2026

Overview

An open, lightweight event-based protocol that standardizes how AI agents connect to user-facing applications for seamless integration with real-time user context and UIs.

Categories

Tags

Similar tools

Install

npm install ag-ui

README

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.



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

FrameworkStatusAG-UI Resources
Built-in Agent✅ Supported➡️ Docs

🤝 Partnerships

| Framework | Status | AG-UI Reso