ag-ui  by ag-ui-protocol

Protocol for agent-user interaction in frontends

created 2 months ago
5,521 stars

Top 9.3% on sourcepulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

AG-UI is an open, event-based protocol designed to standardize and simplify the integration of AI agents into frontend applications. It targets developers building agent-powered user experiences, offering a flexible and interoperable solution for real-time agent-human interaction, including chat, generative UI, and tool use.

How It Works

AG-UI operates on a lightweight, event-driven architecture. Agent backends emit standardized events (16 types) and accept simple AG-UI compatible inputs. A flexible middleware layer ensures compatibility across various transport mechanisms (SSE, WebSockets, webhooks) and allows for loose event format matching, promoting broad interoperability between diverse agent frameworks and frontend applications. A reference HTTP implementation and default connector are provided for rapid setup.

Quick Start & Requirements

  • Install: Client libraries available for TypeScript (via CopilotKit) and Python.
  • Prerequisites: Framework-specific integrations are documented.
  • Resources: Live demos and getting started guides are available for supported frameworks like LangGraph, Mastra, CrewAI, and AG2.

Highlighted Details

  • Supports agentic chat with real-time streaming.
  • Enables bi-directional state synchronization and frontend tool use.
  • Facilitates generative UI and structured messages with delta streaming.
  • Designed for human-in-the-loop and human-on-the-loop collaboration.

Maintenance & Community

The project is actively developed with community contributions welcomed. Upcoming events include webinars and working group meetings. Links to community resources are provided.

Licensing & Compatibility

The specific license is not explicitly stated in the provided README, but the open nature suggests permissive licensing suitable for commercial use and closed-source linking.

Limitations & Caveats

Support for some agent frameworks (e.g., OpenAI Agent SDK, Google ADK) is listed as "Open to Contributions," indicating ongoing development and potential gaps in immediate compatibility. Messaging client integrations are marked as "Work in Progress."

Health Check
Last commit

20 hours ago

Responsiveness

Inactive

Pull Requests (30d)
64
Issues (30d)
32
Star History
5,620 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.