项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1229
使用教程
ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。
环境要求
- 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
下一篇：SWE-AF
同类项目推荐
NemoClaw
开源
在 NVIDIA 沙箱里安全跑各类 AI 智能体，省心又可靠
Run agents like Hermes, LangChain Deep Agents, and OpenClaw more securely inside NVI···
heimdall-agent
开源
让 AI 自主打 CTF 靶场，自动分析并执行利用链
An autonomous AI agent framework for authorized CTF and security labs
Proma
开源
让专业工作流拥有主动式 AI 助手，多模型驱动效率翻倍
Proma brings a seamless general-purpose Agent experience to your workflow. Built for···
polymarket-whale-watcher
开源
盯住Polymarket大户，AI帮你挖出信息差机会
AI-powered whale trade surveillance for Polymarket — real-time monitoring of 700+ m···
MIRIX
开源
自动记住你的屏幕活动，随时问答找回。
Mirix is a multi-agent personal assistant designed to track on-screen activities and···
openfang
开源
像操作系统一样管理你的 AI 智能体，让多智能体协作更稳更高效。
Open-source Agent Operating System
claude-code-plugin-template
开源
快速搭建 Claude Code 插件市场，标准化分发流程
GitHub template for creating Claude Code plugin marketplaces. Includes plugin scaffo···
Locus
开源
用自然语言驱动 Unity 开发，自动写代码改场景
The open source Unity Dev Agent
aideml
开源
喂数据和目标，自动跑实验调模型，输出最优方案
AIDE: an LLM agent for machine learning engineering - the research Weco grew out of.···