5分钟上手 AionUi

快速安装并启动 AionUi,体验本地化 AI 助手图形界面

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Node.js >= 18.0 必需

所需工具

Git

克隆项目代码

必需

操作步骤

1

克隆项目

从 GitHub 克隆 AionUi 项目到本地

克隆项目到当前目录
git clone https://github.com/iOfficeAI/AionUi.git

预期结果:项目文件夹 AionUi 被创建

如果网络较慢,可以使用 GitHub 镜像源

2

安装依赖

进入项目目录并安装所需依赖包

进入项目目录
cd AionUi
安装项目依赖
npm install

预期结果:看到大量依赖包被下载安装,最后显示 'added X packages'

首次安装可能需要几分钟,请耐心等待

3

启动应用

启动 AionUi 图形界面应用

启动 AionUi 应用
npm start

预期结果:看到应用窗口打开,显示 AionUi 主界面

首次启动可能需要一些时间初始化

验证成功

成功启动 AionUi 图形界面应用

看到 AionUi 应用窗口正常打开
界面显示 Gemini CLI 等 AI 工具选项
可以开始与 AI 助手对话

快速提示

配置

如果已安装 Gemini CLI 等工具,AionUi 会自动检测并集成

使用

首次使用建议先体验内置的 Gemini CLI,无需额外配置

调试

按 Ctrl+R (Windows/Linux) 或 Cmd+R (macOS) 刷新界面

常见问题

1

npm install 失败,提示权限错误

使用管理员权限运行命令,或在命令前加上 sudo (macOS/Linux)

2

npm start 后窗口没有打开

检查控制台是否有错误信息,尝试重新运行 npm install

3

Node.js 版本过低

升级 Node.js 到 18.0 或更高版本

下一步

配置 WebUI 远程访问

设置通过浏览器远程访问 AionUi

连接更多 AI 模型

配置 OpenAI、Claude、Ollama 等模型

探索 AI 助手功能

试用 PPT 生成、文件管理等专业助手

助手