一条命令启动AGenUI Studio:100%私密的本地A2UI生成式UI工作台
一条命令启动AGenUI Studio:100%私密的本地A2UI生成式UI工作台
AGenUI Studio 是 AGenUI 生态中的本地 A2UI 生成式 UI 工作台:在终端输入一条 npx agenui-studio 命令,它就能把一句自然语言描述变成可被 AGenUI 原生渲染的 A2UI 协议,并全程在你的电脑上完成——API 密钥、配置和生成结果永不离开本机(No cloud, no lock-in)。
它是什么:把一句话变成可渲染的 A2UI 协议
AGenUI 是一个面向 iOS / Android / HarmonyOS 的高性能流式生成式 UI 渲染器(Native A2UI Renderer),而 Studio 是它的"生产车间":
- 🗣️ 自然语言 → A2UI:驱动 LLM 生成
updateComponents/updateDataModel协议消息,AGenUI 直接原生渲染 - 🌊 实时流式生成:SSE 流式输出,协议实时预览
- 🔁 多轮迭代:基于上一版协议继续追问,持续打磨 UI
- ✅ 协议校验:每次结果都经过校验器检查,给出详细错误与警告
- 📱 真机推送:生成二维码 + 局域网地址,一键推送到真机上的 AGenUI Playground
它并非另起炉灶,而是直接复用了仓库中开源的 A2UI Generation Skill(设计规则约束 + 可执行校验脚本),详见 skills/a2ui-generation/SKILL.md 与 skills/a2ui-generation/scripts/validate_a2ui.py。
一条命令安装启动:npx agenui-studio 快速上手
无需克隆仓库,通过 npm 直接运行(需要 Node.js):
npx agenui-studio # 首次运行:下载 + 环境 + 依赖 + 启动
npx agenui-studio --port 9000 # 指定自定义端口
npx agenui-studio --update # 拉取最新发布版后再启动
首次运行时,启动器会自动完成这些步骤:下载发布包 → 解压到 ~/.agenui/app/ → 在 ~/.agenui/venv/ 创建虚拟环境 → 安装服务端依赖 → 启动服务器 → 自动打开浏览器。全程无人工配置。
从源码运行 AGenUI Studio 的完整步骤
如果你已克隆仓库,可以跳过下载环节直接跑源码。前置要求:Python 3.9+ 与 Node.js 18+。
-
安装服务端依赖(FastAPI + Uvicorn + OpenAI 客户端):
pip3 install -r playground/studio/server/requirements.txt -
构建前端(新克隆仓库必须执行一次,构建产物输出到
server/static/):cd playground/studio/web && npm install && npm run build -
启动服务(回到仓库根目录):
python3 -m playground.studio.server终端会同时打印本机与局域网地址并自动打开浏览器:
AGenUI Studio starting... Local: http://127.0.0.1:8765 Network: http://<your-lan-ip>:8765支持
--host、--port、--no-browser三个可选参数;前端开发可用npm run dev获得热更新。
配置模型与 API Key:密钥 100% 留在本机
Studio 采用 BYOK(Bring Your Own Key) 模式,配置保存在 ~/.agenui/config.json(首次运行自动创建),参考模板见 playground/studio/config.example.json。每个 provider 只需填写 4 个字段:
| 字段 | 说明 |
|---|---|
base_url |
OpenAI 兼容 API 地址 |
api_key |
你的密钥(仅保存在本地,绝不上传) |
model |
模型名称 |
max_tokens |
生成响应的最大 token 数 |
模板内置了 DeepSeek、Qwen、GLM、Moonshot、MiniMax、OpenAI、Gemini、Anthropic、OpenRouter、OrcaRouter 等现成条目,填上密钥即可用,也兼容任意 OpenAI 兼容端点。不想手写 JSON?打开应用内的设置对话框即可增删 provider、切换密钥可见性,修改会自动写回配置文件。
生成结果统一保存在 ~/.agenui/protocols/,并在侧边栏形成"My Generations"本地历史,方便随时回看。
内置预设与真机预览:扫码推送到 Playground
Studio 内置了仓库自带的真实示例协议(来自 samples/protocols/),一键加载,无需输入任何提示词:
想看到真机效果?在 Android / iOS / HarmonyOS 的设备或模拟器上构建运行 playground/ 目录下对应平台的 AGenUI Playground(各平台搭建步骤见 README.md 的"Debugging with the Playground"章节),然后在 Studio 中扫描生成的二维码,协议即推送到设备原生渲染。
常见问题速查
| 问题 | 解决办法 |
|---|---|
| 端口 8765 被占用 | python3 -m playground.studio.server --port 9000 或 npx agenui-studio --port 9000 |
| 提示 "Could not extract A2UI protocol" | 模型输出无法解析为合法 A2UI,换更强的模型或优化提示词 |
| 开启 Reasoning 后生成变慢 | 属正常现象,推理模型会先"思考";关闭开关可提速 |
| 手机连不上服务器 | 确认手机与电脑在同一局域网,使用 Network: 地址;仍被拒绝时检查系统防火墙 |
更多细节可查阅 playground/studio/README.md 的完整文档与 FAQ。
相关文档与模块路径导航
- 📖 完整说明:playground/studio/README.md
- ⚙️ 配置模板:playground/studio/config.example.json
- 🐍 服务端入口:playground/studio/server/main.py
- 🤖 多厂商 LLM 适配:playground/studio/server/providers.py
- 🧩 生成式 UI Skill:skills/a2ui-generation/
- 📦 npm 启动器:npm/agenui-studio/package.json


