What is AGUI?

AGUI (Agent User Interaction) is an open-source, lightweight protocol that standardizes how AI agents connect to front-end interfaces, enabling seamless communication between user-facing applications (like websites) and backend AI agents. It acts as a bridge, streaming events like text updates, tool calls, and state changes via HTTPS/SSE, allowing developers to create interactive, real-time AI apps.

How AGUI Works

Initial Request: A user interacts with an app's front end (e.g., typing a query), which sends a structured request to an AI agent through the AGUI protocol.

Event-Based Communication: As the AI agent runs, it emits structured JSON events (e.g., text, tool usage, state updates) rather than just a final output.

Real-time Updates: AGUI supports Server-Sent Events (SSE), allowing the front end to receive updates immediately, such as text appearing token-by-token or tool-call status.

State Management: AGUI keeps the front-end interface in sync with the agent's internal state, managing context and allowing for human-in-the-loop approvals if needed. 

Key Aspects of AGUI

Standardization: It eliminates custom WebSockets and inconsistent parsing by creating a uniform way for agents (like CrewAI, LangGraph, or Pydantic AI) to talk to front ends.

Bi-directional Interaction: Agents can send information to the user, and users can provide input or interrupt the agent, allowing for dynamic, conversational UI.

Four Core Event Types: AGUI standardizes 16 specific event types under four categories: lifecycle management, text message updates, tool call tracking, and state synchronization.

Not Generative UI: Unlike A2UI (which focuses on what UI to show), AGUI focuses on how that UI data is transmitted between backend and frontend