iOfficeAI / AionUi

27,1672,597+137 todayTypeScript

Giselle：免费、本地化、开源GUI应用，支持Gemini CLI、Claude Code、Codex、Qwen Code、Goose Cli、Auggie等——具备增强型聊天界面、WebUI、多智能体与多LLM支持、MCP集成 | 🌟 如果喜欢，欢迎点赞！

📊 项目信息

语言: TypeScript
Stars: ⭐ 27,167
Forks: 2,597
今日新增: +137
排名: #8
收录: 语言榜
趋势日期: 2026年5月29日
最后推送: 2026/5/29

🏷️ 标签

acpagent-teamaiai-agentchatchatbotclaude-codeclawdbotcodexcoworkgeminigemini-clihermesllmnano-bananaofficeopenclawopencodeskillswebui

📸 截图

5分钟上手 AionUi

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

🖥️ 操作系统

macOSWindowsLinux

⚙️ 运行环境

Node.js>= 18.0

🔧 工具

Git— 克隆项目代码

📝 操作步骤

克隆项目

从 GitHub 克隆 AionUi 项目到本地

克隆项目到当前目录

$ git clone https://github.com/iOfficeAI/AionUi.git

✓预期输出：项目文件夹 AionUi 被创建

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

安装依赖

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

进入项目目录

$ cd AionUi

安装项目依赖

$ npm install

✓预期输出：看到大量依赖包被下载安装，最后显示 'added X packages'

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

启动应用

启动 AionUi 图形界面应用

启动 AionUi 应用

$ npm start

✓预期输出：看到应用窗口打开，显示 AionUi 主界面

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

✅ 验证成功

成功启动 AionUi 图形界面应用

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

⚡ 快速提示

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

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

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

🔍 常见问题排查

❓ npm install 失败，提示权限错误

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

❓ npm start 后窗口没有打开

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

❓ Node.js 版本过低

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

🎯 下一步

配置 WebUI 远程访问

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

连接更多 AI 模型

配置 OpenAI、Claude、Ollama 等模型

探索 AI 助手功能

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

难度

入门

预计时间

1-2小时

目标人群

对AI工具感兴趣，希望用图形界面替代命令行操作的新手；想尝试多AI模型协作，但缺乏编程经验的用户；需要本地化、免费AI办公助手的个人或小团队。

🎯 学完你将掌握

学会安装并运行AionUi，使用图形界面与内置的Gemini CLI等AI工具交互，并体验其核心的WebUI访问、文件管理和多会话功能。

📋 前置知识

基本的电脑操作了解

需要会下载文件、解压压缩包、运行应用程序等基础操作。

网络连接了解

部分AI模型（如Gemini）需要联网才能使用。

命令行工具（如Gemini CLI）了解(可选)

非必须，但如果你已安装，AionUi能自动检测并提供统一界面。没有安装也能直接使用内置的Gemini CLI。

📚 学习资源

必看

项目GitHub README

本项目最核心的文档，包含了功能介绍、对比、快速导航等。特别是“Remote Internet Access Tutorial”（远程访问教程）链接，如果你想配置公网访问，这是必看内容。

🗺️ 学习阶段

环境准备与安装

⏱ 15-30分钟

下载AionUi

访问项目GitHub页面（iOfficeAI/AionUi）的Releases部分，根据你的操作系统（Windows/macOS/Linux）下载最新的安装包或可执行文件。

💡Windows用户通常下载.exe文件，macOS下载.dmg，Linux下载.AppImage或对应包。

安装与首次运行

运行下载的安装程序，或直接启动可执行文件。首次启动后，熟悉主界面布局。

💡如果系统有安全提示（如macOS的“无法验证开发者”），请根据系统指引允许运行。首次启动可能需要一点时间初始化。

快速入门：第一次对话

⏱ 20-30分钟

启动内置AI（Gemini CLI）

在AionUi主界面，确认已选择或自动检测到“Gemini CLI”作为当前模型。如果提示需要API密钥，你可能需要先获取并配置Gemini API Key（项目内置的Gemini CLI可能已包含基础访问权限，具体看版本说明）。

💡关注界面提示，如果内置模型可用，通常可以直接开始聊天。

进行第一次对话

在聊天输入框，用自然语言向AI提问，例如：“帮我写一个简单的Python函数来计算斐波那契数列”。体验发送、接收回复的过程。

💡首次回复可能需要一些时间，取决于网络和模型加载情况。

体验多会话

尝试新建一个会话（通常有“New Chat”或“+”按钮），在新会话中问另一个问题。观察两个会话是否独立，互不干扰。

💡这是AionUi的核心优势之一，可以同时进行多个不同主题的对话。

核心功能初探

⏱ 30-45分钟

体验WebUI访问（本地）

在AionUi的设置中，找到“WebUI设置”或类似选项，启用本地WebUI服务。记下显示的本地地址（如 http://localhost:端口号）。在同一局域网下的另一台设备（如手机）的浏览器中输入该地址，尝试访问AionUi界面。

💡这能让你在任何设备上通过浏览器使用AionUi。确保电脑防火墙允许该端口的连接。

使用预览面板

让AI生成一些有格式的内容，例如：“用Markdown格式写一份会议纪要”。在AI回复后，尝试点击“预览”或类似按钮，查看生成的Markdown内容的渲染效果。

💡支持PDF、代码、Markdown等多种格式的即时预览，无需打开其他软件。

浏览AI助手库

在主界面或侧边栏找到“AI Assistants”或“技能”入口，浏览内置的10多个专业助手（如PPT生成器、PDF转换器等）。选择一个你感兴趣的助手（如“PPTX Generator”），点击进入并尝试根据简单提示使用它。

💡每个助手专注于特定任务，可以极大提升效率。首次使用某个助手可能需要加载相关技能。

⚠️ 常见错误

❌ 启动后找不到或无法使用AI模型

✅ 1) 确认网络连接正常；2) 检查设置中是否已正确选择并配置了某个模型（如Gemini）；3) 如果是使用需要API Key的模型（如OpenAI），确保已在对应位置正确填写了有效的API Key；4) 尝试重启AionUi。

❌ WebUI无法在手机/其他电脑上访问

✅ 1) 确保运行AionUi的电脑和访问设备在同一个局域网（Wi-Fi）下；2) 检查AionUi中WebUI服务是否已启用，并记对IP地址和端口；3) 暂时关闭电脑的防火墙或杀毒软件试试（完成后记得重新打开）；4) 先尝试用运行AionUi的电脑本身的浏览器访问 localhost:端口，确认服务本身是否正常。

❌ 认为必须安装所有命令行工具（如Claude Code）才能用

✅ AionUi内置了Gemini CLI，可以直接使用。其他工具（Claude Code等）是“如果已安装，则自动集成”，并非必需。新手完全可以只使用内置功能。

❌ 忽略本地存储位置

✅ AionUi的对话和文件默认保存在本地。如果你需要备份或迁移数据，记得在设置或文档中查找本地数据存储路径，避免重装系统后数据丢失。

🚀 后续方向

1. 配置远程公网访问：按照教程设置，实现随时随地通过互联网访问你的AionUi。 2. 集成更多AI模型：尝试在设置中添加并配置OpenAI、Claude、Ollama（本地模型）等，体验多模型切换。 3. 探索高级助手：深度使用“文件智能管理”、“PPTX生成器”等专业助手，完成实际办公任务。 4. 尝试自定义技能：如果你有编程基础，可以学习在`skills/`目录下创建自己的技能，扩展AI能力。 5. 参与社区：在Discord或微信群分享你的使用经验，或向开发者反馈问题。