a2ui

环境要求

• Flutter SDK（使用 Flutter 渲染器时需要）
• 一个前端工程（React / Angular / Lit 之一）用于承载渲染器
• 一个可输出 JSON 布局的智能体或智能体框架（如 AG-UI 应用）
• 访问 a2ui.org 与 GitHub 仓库的网络环境

安装与启动步骤

1. 1选择上手路径

   README 给出四条路径：本地全栈 Quickstart、任意框架接入、Composer、Theater，按需求选一条。

2. 2免安装生成布局 JSON

   打开 A2UI Composer 可视化编辑器，生成 A2UI JSON 后粘贴到任意智能体提示词中，无需安装。

3. 3预览流式渲染效果

   打开 A2UI Theater，逐步查看 Lit、React、Angular 三种渲染器的预置流式场景。

4. 4获取仓库代码

   克隆仓库，获得各端渲染器源码以及 docs 目录下的接入指南文档。

   git clone https://github.com/a2ui-project/a2ui

   复制

5. 5安装 Flutter 渲染器

   在 Flutter 工程目录执行；README 说明这两个包取代原有的 genui 包。

   flutter pub add a2ui_flutter a2ui_core

   复制

6. 6接入自有智能体框架

   参照仓库指南为你的框架搭建 AG-UI 应用或 harness，再开启 A2UI 渲染。

7. 7跑通本地全栈示例

   打开官网 Quickstart 页面，按页面说明启动 Gemini 驱动的 ADK 智能体与 Lit 渲染器。

如何确认成功

按 Quickstart 页面启动后触发一次对话，能看到 A2UI 卡片随流式数据逐步渲染出来；或在 Theater 中场景可正常播放。

常见问题

注意事项

• README 只给出 Flutter 包的安装命令，其余路径的具体命令需以官网 Quickstart 与仓库 docs 为准。
• 当需要 Flutter、Angular、SwiftUI / Jetpack Compose 或多端同源渲染时，优先考虑 A2UI。
• 当智能体是远程、第三方或跨信任边界时，用 A2UI 可避免向渲染端下发可执行代码。
• 本文基于 README 节选整理，未提及的端口、环境变量等参数请查阅仓库文档。