@amd-gaia/agent-ui

中文文档
0.26.0发布于 2026/11/18MITESM + CJS构建来源已验证近 30 天下载 5071

在 AMD Ryzen AI 上与 GAIA 代理 - 默认的本地和私人聊天, 选择时的云模型

中文使用文档
文档目录9 节
  1. 安装
  2. 先决条件
  3. 使用量
  4. 特征
  5. 建筑
  6. 桌面安装器
  7. 文档
  8. 发展
  9. 许可证

@amd-gaia/ 代理用户

一个GAIA代理的聊天窗口——在AMD Ryzen AI硬件上默认是本地和私有的,在选择时有云模型(Fireworks AI,AMD LLM Gateway).

默认情况下没有云和 API 密钥,也没有数据离开您的设备 。 选择一个云模型会把谈话发送给它的供应商.

安装

npm install -g @amd-gaia/agent-ui

先决条件

GAIA Agent UI 需要本地运行的 Python 后端:

# Install the GAIA Python package
pip install amd-gaia

# The LLM backend (AMD Ryzen AI accelerated) starts automatically with the
# GAIA daemon; start it explicitly only if it isn't already running.
gaia daemon start

使用量

# Start GAIA Agent UI (launches backend + opens browser)
gaia-ui

# Custom port
gaia-ui --port 4200

# Frontend-only mode (if backend is already running)
gaia-ui --serve

# Don't auto-open browser
gaia-ui --no-open

然后打开 http://localhost:4200 (英语) 在您的浏览器中.

特征

  • 私营 —— 默认情况下在您的AMD硬件上进行本地处理,除非选择云模型,否则没有数据离开您的设备.
  • B. 精简答复 ——以活性代理活性可视化方式实时代币流.
  • 文件QQA ——上传PDF,代码文件,以及用于RAG能动问答的文档.
  • 代理活动 ——看AI实时思考,规划和使用工具.
  • 会话管理 ——创建,搜索,重命名,导出,并删除聊天会话.
  • 暗灯模式 ——以手动切换方式自动进行主题检测.
  • 移动接入 - 通过安全通道与你的电话分享本地聊天.
  • 标记下渲染 ——代码块,粗体,斜体,列表,以及响应中的链接.
  • 键盘快捷键 — 输入发送, Shift+ 输入新行 .

建筑

Browser  <-->  Python Backend (FastAPI, port 4200)  <-->  Lemonade Server (LLM, port 13305)
                    |
                SQLite DB (~/.gaia/chat/)

Npm 包包括:

  • 预建的 React 前端 由 Python 后端服务
  • CLI 发射器 (单位:千美元)gaia-ui开始后端并打开浏览器
  • 独立服务模式 (单位:千美元)--serve)独立服务前端

桌面安装器

对于本地桌面体验,请从 GitHub 发布数字 :

  • 窗口数字 : gaia-ui-setup.exe
  • 乌邦图/ 利纳数字 : gaia-ui-setup.deb

文档

发展

# Clone the repo
git clone https://github.com/amd/gaia.git
cd gaia/src/gaia/apps/webui

# Install dependencies
npm install

# Start dev server (proxies API to localhost:4200)
npm run dev

# Build for production
npm run build

许可证

麻省理工学院——见 自由主义

版本与发布记录

@amd-gaia/agent-ui 共发布 95 个版本,首次发布于 2026/03/28;过去 12 个月发布了 95 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.26.0latest2026/11/18今天
0.26.0-rc.32next2026/11/17今天
0.26.0-rc.302026/11/152 天前
0.26.0-rc.292026/11/153 天前
0.26.0-rc.282026/11/143 天前
0.26.0-rc.272026/11/143 天前

关于 @amd-gaia/agent-ui 的常见问题

@amd-gaia/agent-ui 是什么?

在 AMD Ryzen AI 上与 GAIA 代理 - 默认的本地和私人聊天, 选择时的云模型

如何安装 @amd-gaia/agent-ui?

在项目目录运行 npm install @amd-gaia/agent-ui,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gaia-ui,可以用 npx gaia-ui 直接运行。

@amd-gaia/agent-ui 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/amd-gaia__agent-ui 是否存在。

@amd-gaia/agent-ui 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@amd-gaia/agent-ui 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@amd-gaia/agent-ui 可以商用吗?

@amd-gaia/agent-ui 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@amd-gaia/agent-ui 的下载量有多少?

根据 npm 官方下载统计,@amd-gaia/agent-ui 在 2026/10/06 – 2026/11/04 这 30 天内被下载 5,071 次,日均约 169 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@amd-gaia/agent-ui 还在维护吗?

最新版本 0.26.0 发布于 2026/11/18(今天);至今共发布 95 个版本,其中过去 12 个月发布了 95 个;首次发布于 2026/03/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。