AGenUI/AGenUI

Native A2UI Renderer for iOS/Android/HarmonyOS. High performance streaming Generative UI. Custom Components, Styles and more.

AGenUI 是一个开源 SDK,可将大语言模型的流式输出实时转换为三大主流移动平台上的原生交互式 UI。当 LLM 代理决定屏幕应显示的内容时,它会输出一条描述 UI(文本、按钮、表单、列表、图片、视频等)的结构化消息。AGenUI 会在消息到达时逐段解析(如同实时数据流),并在设备上绘制相应的原生 UI 组件,因此界面会在模型生成过程中即时显示和更新。

它基于 A2UI v0.9 协议构建,这是 Google 开源的一种标准方式,用于 LLM 代理描述 UI。AGenUI 完全实现了该规范,并添加了自己的扩展。

工作原理: 共享的 C++ 核心引擎负责处理所有平台通用的繁重任务——流式数据解析、构建虚拟组件树、缓存渲染数据、解析主题/样式以及差异计算。在其之下,三个平台专用渲染引擎(iOS、Android、HarmonyOS)从 C++ 层接收解析后的组件描述,并使用各系统的原生 UI 能力进行绘制。这提供了流畅、高刷新率的渲染(在滚动等核心场景下可达 120fps)。

主要功能:

  • 22 个内置组件——A2UI 规范中的 18 个(Text、Image、Button、Card、List、Tabs、Slider、CheckBox、Modal 等)加上 4 个 SDK 扩展(Table、Carousel、Web、RichText)。您还可以在运行时注册自定义的原生组件。
  • Function Call 集成——开发人员可以注册客户端工具,供 LLM 按需调用。v1.7.0 新增了一个内置的 resolveCalls 函数,可递归执行 JSON 中的嵌套函数调用,并用其结果替换每个调用节点。
  • 设计令牌与主题——在所有三个平台上提供统一的令牌系统以及浅色/深色模式。
  • 目录文件(agenui_catalog.json)——一个自包含、独立的 JSON Schema(符合 A2UI v0.9),描述了全部 25 个组件和 14 个函数。代理将其用作约束,确保 LLM 输出严格符合要求的 UI 描述。
  • A2UI 生成技能(skills/a2ui-generation/)——一个独立技能,可挂载到任何支持 Agent Skills 机制的代理(如 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等)中。它引导 LLM 将自然语言查询转换为 AGenUI 可直接渲染的 A2UI 协议消息。可使用 npx skills add AGenUI/AGenUI 安装。
  • AGenUI 工作室——一个本地、自带密钥的工坊(npx agenui-studio),可将自然语言转换为 A2UI 协议,并提供浏览器 UI,支持流式生成、实时协议预览、验证,以及通过二维码一键推送到真实设备上的 Playground。支持多个 LLM 提供商(DeepSeek、Qwen、GLM、OpenAI、Gemini 等)。

项目结构:

  • core/——C++ 核心引擎(解析器、差异计算、布局、Function Call 框架)
  • platforms/ios|android|harmony/——原生渲染器及桥接层(Objective-C、JNI、NAPI)
  • playground/——各平台的演示应用(用于开发和调试)
  • scripts/——各平台的构建脚本

项目以 Apache 2.0 许可证发布,目前处于积极开发阶段(当前版本 v1.7.0,发布于 2026-10-19)。请注意,变更日志日期为 2026 年底,因此这是一个快速发展的项目。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目