一条命令启动AGenUI Studio:100%私密的本地A2UI生成式UI工作台

原创2026-10-13 23:32:321,901 阅读
文章标签:人工智能大模型AI 应用移动开发UI组件

一条命令启动AGenUI Studio:100%私密的本地A2UI生成式UI工作台

AGenUI Studio 是 AGenUI 生态中的本地 A2UI 生成式 UI 工作台:在终端输入一条 npx agenui-studio 命令,它就能把一句自然语言描述变成可被 AGenUI 原生渲染的 A2UI 协议,并全程在你的电脑上完成——API 密钥、配置和生成结果永不离开本机(No cloud, no lock-in)。

AGenUI生成的A2UI航班行程卡片渲染效果

它是什么:把一句话变成可渲染的 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+。

  1. 安装服务端依赖(FastAPI + Uvicorn + OpenAI 客户端):

    pip3 install -r playground/studio/server/requirements.txt
    
  2. 构建前端(新克隆仓库必须执行一次,构建产物输出到 server/static/):

    cd playground/studio/web && npm install && npm run build
    
  3. 启动服务(回到仓库根目录):

    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/),一键加载,无需输入任何提示词:

AGenUI Studio预设的A2UI外卖订单卡片渲染效果

AGenUI生成的A2UI城市天气对比界面渲染效果

想看到真机效果?在 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。

相关文档与模块路径导航

登录后查看全文
AGenUI