Skip to content

amrmelsayed/ag-ui

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

AG-UI is a lightweight, event-based protocol that standardizes how AI agents connect to front-end applications. Built for simplicity and flexibility, it enables seamless integration between your AI agents and user interfaces.

Version MIT Discord

Banner

🚀 Getting Started

Create a new AG-UI application in seconds:

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

Building AG-UI Integrations (new frameworks):

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

🚀 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

1st party integrations with top agentic frameworks

🛠 Supported Frameworks

AG-UI integrates with many popular agent frameworks

Framework Status AG-UI Resources
No-framework ✅ Supported ➡️ Docs coming soon
LangGraph ✅ Supported ➡️ Demo
Mastra ✅ Supported ➡️ Demo
CrewAI ✅ Supported ➡️ Demo
AG2 ✅ Supported ➡️ Demo
Agno ✅ Supported ➡️ Docs
LlamaIndex ✅ Supported ➡️ Docs
Pydantic AI 🛠️ In Progress
Vercel AI SDK 🛠️ In Progress
Google ADK 🛠️ In Progress
OpenAI Agent SDK 💡 Open to Contributions
AWS Bedrock Agents 💡 Open to Contributions
Cloudflare Agents 💡 Open to Contributions
Strands Agents SDK 💡 Open to Contributions
Language SDK Status AG-UI Resources
.NET 🛠️ In Progress ➡️ PR
Nim 🛠️ In Progress ➡️ PR
Rust 🛠️ In Progress

View all supported frameworks →

✨ Hello World App

Video:

agui-hello-world-2.mp4

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

🧩 AG-UI Showcase: The AG-UI Dojo (Building-Blocks Viewer)

The AG-UI Dojo showcases many of the building blocks that AG-UI supports (AG-UI Dojo Source Code).

The building blocks are designed to be simple and focused -- between 50-200 lines of code.

dojo-hello.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.
Maintained by AG Protocol.

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 66.2%
  • Python 30.4%
  • CSS 1.9%
  • JavaScript 1.5%