a2ui-project/a2ui

▲ 473 stars today★ 17,269⑂ 1,399

Open-source generative UI framework: agents stream layout data, and apps render it with native components in React, Angular, Lit, Flutter, SwiftUI and Jetpack Compose.

About a2ui-project/a2ui

a2ui-project/a2ui is an open-source project on GitHub, mainly written in TypeScript. Open-source generative UI framework: agents stream layout data, and apps render it with native components in React, Angular, Lit, Flutter It currently holds 17,269 stars and 1,399 forks with 486 open issues, and was last pushed on 2026-11-13 (repository created 2025-09-24).

Project Overview

Git Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository a2ui-project/a2ui · default branch main · size 296866 KB · watchers 93 · source: GitHub REST API and repository README

README

A2UI

Build delightful, fast, reliable agentic experiences

A2UI (Agent-to-User Interface) is an open-source generative UI framework, complete with a protocol optimized for streaming dynamic user interfaces at low latency, native renderers for web and mobile frameworks, and agent SDKs in several popular languages. With A2UI, your agents can communicate with your users using natively rendered widgets, in addition to text.

https://github.com/a2ui-project/a2ui/blob/HEAD/Gallery of A2UI components

_Examples of UI compositions that A2UI can express._

Quick links

Introduction

Large language models (LLMs) and decision models (e.g. Jev) excel at creating text and code and at making fast decisions on top of raw structured data (e.g. JSON). A2UI gives these models a specialized vocabulary for expressing user interfaces.

A2UI expresses UI using _data_, not code. A schema for the data exchanged between the agent and the renderer enforces strict capability boundaries for the agent, keeping agent-generated experiences safe and aligned with the business requirements of your application. A _core library_, a _native framework adapter_, and a _catalog of components_ provide access to native components and form the building blocks that the agent _composes_ into a final user experience, making the result expressive and high-performance.

When to use A2UI

Use A2UI when any of the following apply to your application:

supports remote rendering. need. Instead of making your users navigate through multiple screens to solve their problems, have the agent build the right flow of UI that guides users directly to solutions. the framework of your choice, typically one that the host app itself is written in. WebViews or HTML are not required. Flutter, React, SwiftUI, and Jetpack Compose. A2UI helps keep the user experience compatible and consistent across all screens. example, the agent must not be able to handle certain kinds of data (credit card/account numbers, PII, financial data). A2UI helps enforce the trust boundary and protect your app's critical functionality from hallucinations using a strict schema, and by expressing UI using validated data rather than executable code.

A2UI core philosophy

We develop A2UI under the guidance of the following core principles:

do in the app. A2UI provides a framework for specifying and enforcing the necessary guardrails, such as expressing UI as data, validating inputs and outputs against a schema, and disallowing arbitrary executable code. Every capability granted to the agent is either a safe standard capability built into the framework, or a capability explicitly granted by the app developer. efficiently generated by language and decision models and transported over the network, and to support progressive rendering (or "streaming") for a responsive user experience. An agent can adapt the UI based on where the user takes the conversation. A2UI supports swappable inference formats, so you can tailor inference to specific models and use cases. native to your app, with renderers for many major UI frameworks. No need to change frameworks unless required for other reasons.

Architecture

A2UI's architecture is made of multiple layers spanning the full stack that connects the agent to the application:

1. Inference: An agent (typically backed by a language or a decision model) instructed by an A2UI skill (created using an A2UI Agent SDK) generates the description of UI and data using an appropriate inference format (e.g. A2UI Express, or a decision tree). 2. Transport: An A2UI Agent SDK, embedded in a larger agent architecture, parses and validates the model's output, expands macros, and converts the UI to the wire-stable _A2UI Transport_ protocol messages, which are sent to the renderer. 3. Rendering: A renderer is made of an _A2UI Core_ library (e.g. the @a2ui/web_core npm package, or a2ui_core Dart package), a UI framework adapter (e.g. @a2ui/react React adapter, or a2ui_flutter Flutter adapter), and a widget catalog. The core library parses the incoming messages and creates a framework-agnostic in-memory representation of the UI and data. The framework adapter maps the in-memory representation to concrete framework-specific UI widgets. The widget catalog provides access to the widgets the agent is allowed to compose.

Getting started

Pick the path that matches where you want to start:

| Path | What you get | Time | | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------ | | 🍜 Quickstart | A full-stack A2UI app with a backend and frontend. Learn A2UI end-to-end and customize to your use case. | ~5 min | | 🎨 A2UI Composer | Generate A2UI JSON from a visual editor and paste it into any agent prompt — no install required. | ~1 min | | 🎬 A2UI Theater | Step through pre-built A2UI streaming scenarios across Lit, React, and Angular renderers — no install required. | ~1 min |

Packages

These packages are developed in this repository. Packages marked "Not published yet" can be used from source.

Python

| Package | Description | Version | | ------------------------------------ | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | a2ui-core | Protocol messages, data model, data binding, expression evaluation, and catalog validation. | PyPI | | a2ui-agent-sdk | Agent SDK: negotiates catalogs, generates prompts and skills, and compiles model output into A2UI. | PyPI | | a2ui-a2a | Connects the agent SDK to the Agent-to-Agent (A2A) protocol. | PyPI | | a2ui-adk | Connects the agent SDK to the Agent Development Kit (ADK). | PyPI |

TypeScript

| Package | Description | Version | | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | @a2ui/web_core | Protocol messages, state management, expressions, and basic catalog shared by renderers and @a2ui/agent. | npm | | @a2ui/lit | Lit (web components) renderer. | npm | | @a2ui/angular | Angular renderer. | npm | | @a2ui/react | React renderer. | npm | | @a2ui/markdown-it | Markdown rendering with markdown-it and DOMPurify, shared by the web renderers. | npm | | @a2ui/agent | Agent SDK: negotiates catalogs, generates prompts and skills, and compiles model output into A2UI. | npm | | @a2ui/catalog-mcp | MCP catalog: calls MCP tools and renders A2UI messages returned in tool results and UI resources. | npm | | @a2ui/catalog-vegachart | VegaChart catalog: renders Vega and Vega-Lite chart specifications on A2UI surfaces. | Not published yet |

Dart and Flutter

| Package | Description | Version | | ---------------------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | a2ui_core | Protocol messages, data model, data binding, and expressions for renderers and agents. | pub | | a2ui_agent | Agent SDK: negotiates catalogs, generates prompts and skills, and compiles model output into A2UI. | pub | | a2ui_flutter | Flutter renderer. | pub | | a2ui_cli | Developer tool that generates typesafe component code from a catalog. | GitHub Releases |

Swift

The Swift libraries are distributed via Swift Package Manager from Package.swift at the root of this repository.

| Package | Description | | -------------------------------------------------- | ------------------------------------------------------------------------------------ | | A2UISwiftCore, BasicCatalog | Message processor, data model, expression evaluation, and basic catalog definitions. | | A2UISwiftUI, BasicCatalogSwiftUI | SwiftUI renderer and basic catalog views. |

Roadmap

the A2UI protocol. primitives for rendering reusable rich UI widgets. more agent frameworks. into MCP Apps. coding agents.

Contribute

A2UI is an Apache 2.0 licensed project. We believe the future of UI is agentic, and we want to work with you to help build it.

See CONTRIBUTING.md for details on how to get started.

GitHub Stars & Activity

17,269Stars
1,399Forks
486Open issues
TypeScriptLanguage

GitHub Popularity

GitHub stars17,269
Forks1,399
Open issues486
Primary languageTypeScript
LicenseApache-2.0
Stars gained today473
Created2025-09-24
Last pushed2026-11-13

Trending History

Weekly boardrank #86 · ▲ 473 stars

Related GitHub Projects

1

stablyai / orca

TypeScript★ 127,260⑂ 8,075▲ 1,052 stars
→
2

ChromeDevTools / chrome-devtools-mcp

TypeScript★ 57,914⑂ 4,863▲ 841 stars
→
3

tashfeenahmed / freellmapi

TypeScript★ 53,735⑂ 7,551▲ 649 stars
→
4

dream-num / univer

TypeScript★ 28,626⑂ 2,606▲ 1,828 stars
→
5

milind-soni / OpenMausBot

TypeScript★ 24,497⑂ 3,418▲ 662 stars
→
6

ag-ui-protocol / ag-ui

TypeScript★ 19,726⑂ 2,037▲ 791 stars
→
7

cursor / plugins

TypeScript★ 16,722⑂ 1,787▲ 196 stars
→
8

backnotprop / plannotator

TypeScript★ 12,862⑂ 1,287▲ 696 stars
→

More Trending Repositories