AGenUI

让 AI 在手机端原生渲染动态界面，流畅如丝滑

AGenUI 是一个跨平台的原生生成式 UI 渲染引擎，专为 iOS、Android 和 HarmonyOS 设计。它解决的是 AI 智能体在移动端动态生成界面时性能差、体验割裂的问题，核心能力是高性能流式渲染 A2UI 协议，支持自定义组件和样式，让 LLM 输出的 UI 描述能实时、流畅地呈现在原生应用中。它采用 C++ 编写，底层直接对接各平台原生渲染，避免了 WebView 的开销，从而实现了接近原生应用的流畅度和响应速度。项目处于成长阶段，已获得千余星标，适合需要深度集成生成式 UI 的移动 AI 应用开发者。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1168

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队AGenUI

所属国家

官网地址https://genui.amap.com

GitHubhttps://github.com/AGenUI/AGenUI

定价模式free

价格说明开源项目，Apache-2.0 许可证，可免费使用和部署。

访问状态

是否开源是

开源协议Apache-2.0

主要语言C++

技术栈/模型a2ui,agent-ui,agenui,ai-agents,ai-generative-ui,cross-platform,generative-ui,harmonyos,llm-ui,native-rendering,native-ui,server-driven-ui,streaming-ui

GitHub 星标★ 1168

30天Star增速

HF 下载量

上线时间2026-03-22 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js / npx 环境（用于 npx skills add 一键安装）
git（用于手动 clone 仓库）
已安装受支持的 AI coding agent 运行时（如 Claude Code、Cursor、Codex、Gemini CLI、Windsurf、GitHu
如需构建 iOS 端：macOS 与 CocoaPods 环境

安装与启动步骤

1确认基础环境

先确认本机已装 Node.js（npx 随 Node 一起提供）与 git，否则后面两条安装命令都无法执行。
```
node -v
git --version
```
2一键安装 Skill

官方推荐方式，一条命令把 AGenUI Skill 装到当前 AI coding agent 运行时，自动适配 55+ 种运行时。
```
npx skills add AGenUI/AGenUI
```
3或手动安装

先克隆仓库，再把 skills/a2ui-generation 目录复制到 Claude Code 的技能目录，适合无法联网批量安装的场景。
```
git clone https://github.com/AGenUI/AGenUI.git
cp -r AGenUI/skills/a2ui-generation ~/.claude/skills/
```
4适配其他运行时

使用 Cursor、Codex 等其他运行时，只需把同一技能目录复制到对应的 skills 目录即可。
```
cp -r AGenUI/skills/a2ui-generation ~/.cursor/skills/
cp -r AGenUI/skills/a2ui-generation ~/.codex/skills/
```
5构建 iOS 端

iOS 侧使用仓库脚本构建，加 --pod-install 参数会先强制执行 pod install 再编译。
```
./scripts/ios/build.sh --pod-install
```
6在智能体中使用

安装完成后，直接在你的 agent 查询里用自然语言描述想要的界面，Skill 会驱动 LLM 输出符合 A2UI 协议描述的 JSON。

关键配置

配置项	必填	说明	示例
`setRuntimeConfig`	否	iOS 运行时配置 API，接收宿主传入的 JSON 运行时开关，在 SDK 初始化阶段、任何 surface 渲染前调用一次。	`AGenUI.setRuntimeConfig("{"borderPixelAlignment":true}")`
`borderPixelAlignment`	否	iOS 物理像素对齐开关，默认开启；开启后发丝边框提升为整数物理像素宽，组件边框吸附到物理像素栅格。	`true`

如何确认成功

安装后在 agent 中描述一个界面需求，若返回符合 A2UI v0.9 规范的 JSON 协议描述，说明 Skill 已生效。

常见问题

Q：一键安装支持哪些 AI coding agent 运行时？

A：支持 55+ 种运行时，包括 Claude Code、Cursor、Codex、Gemini CLI、Windsurf、GitHub Copilot 等，npx skills add 会自动适配。

Q：不用 Claude Code，技能目录该放哪？

A：把仓库里的 skills/a2ui-generation/ 目录复制到对应运行时的技能目录，例如 ~/.cursor/skills/ 或 ~/.codex/skills/。

Q：iOS 端怎么构建？

A：在仓库根目录执行 ./scripts/ios/build.sh --pod-install，会先强制 pod install 再构建。

Q：安装后如何使用？

A：在 agent 的查询中直接描述你想要的 UI，Skill 会驱动 LLM 输出 A2UI v0.9 规范的 JSON 协议。

Q：运行时配置需要调用几次？

A：iOS 的 AGenUI.setRuntimeConfig(_:) 接收宿主 JSON 开关字符串，在 SDK 初始化时、任何 surface 渲染之前调用一次即可。

注意事项

项目处于活跃开发阶段、迭代较快，建议关注仓库更新与 v1.5.0 等版本变更说明。
手动安装时务必复制的是 skills/a2ui-generation/ 整个目录，而不是仓库根目录。
完整接入流程请参考官方文档 docs/QuickStart.md 与 docs/API.md，官网 https://genui.amap.com。

核心亮点

原生渲染，性能远超 WebView，适合高帧率流式输出
一套代码覆盖 iOS/Android/HarmonyOS，跨端成本低
支持自定义组件和样式，灵活适配业务视觉需求

不足之处

项目较新，生态和文档尚不完善，上手门槛偏高
仅支持 A2UI 协议，需自行适配 LLM 输出格式

适用场景

AI 助手动态生成操作面板或表单
移动端实时流式展示 AI 生成的内容卡片
跨端智能体应用需要统一 UI 渲染层

替代项目

SwiftUI (Apple)、Jetpack Compose (Android)、Flutter

项目介绍

AGenUI 是智能体领域的开源项目，由 AGenUI 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,168）位列前 30%，在智能体分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,087 增加到 1,168，净增 81。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可免费使用和部署。

它主要面向的使用场景是：AI助手动态生成操作面板或表单。同类可对比的替代方案包括 SwiftUI (Apple)、Jetpack Compose (Android)、Flutter。

上一篇：boring-is-all-you-need

下一篇：SWE-AF