项目概述
AionUi 是一个开源、本地运行的协作工作台,面向日常开发中频繁使用多种 AI 编码工具的场景而生。它的目标是把 Gemini CLI、Claude Code、Codex、OpenCode、Qwen Code、Goose CLI、Auggie 等能力整合到同一套一致的交互与管理体验中,让开发者在任何时间都能稳定、顺手地调用与切换。项目解决了多工具并行带来的配置分散、入口割裂、上下文难以承接与效率下降等问题,通过统一的界面与工作流,把“选择工具”变成“专注产出”。其独特价值在于强调 本地与自由:更可控的运行环境、更少依赖外部服务,同时保持开放扩展,便于接入更多模型与 CLI 生态;配合 24/7 的使用定位,适合作为个人或小团队的长期 AI 开发中枢。

项目统计
项目概况
14834 Stars |
1139 Forks |
14834 Watchers |
114 Issues
开源协议: Apache License 2.0 |
创建于: 2025-08-07 |
更新于: 2026-02-11
技术栈
该项目主要使用 TypeScript 开发,占代码库的 89.1%。此外还包含 Python (8.4%)、JavaScript (1.8%)、CSS (0.7%)
核心功能
AionUi 主打“本地优先 + 开源免费”的 24/7 协作体验,把一堆常用代码智能体与 CLI 工具聚合到一个顺手的界面里,让你写代码、跑命令、对话式解决问题更像在同一张工作台上完成。它特别适合希望数据留在本机、又想随时调用强力模型能力的开发者与团队。
- 多工具统一入口:面向 Gemini CLI、Claude Code、Codex、OpenCode、Qwen Code、Goose CLI、Auggie 等提供一致的使用方式,减少频繁切换与配置成本。
- 随时在线的“Cowork”:把日常开发中的问答、改代码、查思路、跑指令串成连续工作流,像有个不下线的搭档陪你推进任务。
- 本地运行更安心:强调本地与开源属性,适合对隐私与可控性有要求的场景,部署与使用更自由。
- 为效率而生的交互:更轻量的操作路径,让你把注意力放在“解决问题”而不是“管理工具”上。
更多功能特性正在不断完善中。
技术架构
AionUi 采用 TypeScript 构建,整体以“本地优先、开源可扩展、面向多 CLI 协作”为核心设计。前端 UI 负责统一交互与状态管理,后端/本地服务层负责进程调度与工具编排,通过适配器模式对接 Gemini CLI、Claude Code、Codex、Qwen Code 等不同实现,抽象出一致的会话、任务与工具调用接口,降低接入成本并便于横向扩展。系统强调 24/7 常驻运行与低延迟体验,关键能力包括本地执行、资源隔离与可观测的任务生命周期管理。典型流程可概括为:用户在 UI 发起请求 → 路由到对应 Provider 适配器 → 执行命令/工具链(可组合)→ 统一格式化结果与日志 → 回传 UI 展示与继续协作。该架构在保证隐私与可控性的同时,支持多模型/多工具并行演进,适合持续集成新的 AI 编码工作流。
使用指南
-
安装
- 准备环境:Node.js 18+、Git(可选)。
- 获取项目:
git clone https://github.com/iOfficeAI/AionUi.git && cd AionUi - 安装依赖:
npm i(或pnpm i/yarn) - 启动开发:
npm run dev,浏览器打开终端提示的地址(常见为http://localhost:3000)。 - 生产构建:
npm run build && npm run start
-
连接/使用本地 CLI(示例:Gemini/Claude/Codex/OpenCode 等)
AionUi 会调用你本机已安装的 CLI,因此先确保对应工具能在命令行直接运行(如gemini --help、claude --help)。在 AionUi 的配置中填写“执行命令/参数”和环境变量。# 启动后在 Web UI 里选择 Provider/Tool,并填写命令 # 例如:Gemini CLI export GEMINI_API_KEY="xxx" # 例如:Claude Code export ANTHROPIC_API_KEY="xxx" -
常用配置(建议以 .env 管理)
在项目根目录新建.env,写入密钥与默认参数,避免每次手动输入:GEMINI_API_KEY=xxx ANTHROPIC_API_KEY=xxx OPENAI_API_KEY=xxx # 可按需加入:代理、默认模型、端口等 -
快速验证
npm run dev启动 AionUi- 在 UI 中选择一个已安装的 CLI Provider
- 输入提示词并执行,确认能返回结果;若失败,优先检查:密钥是否生效、CLI 是否在 PATH、以及终端输出的报错信息。
总结评价
AionUi 是一个以 本地化、开源、可长期运行 为核心的开发协作与“代理”类 UI/工具集合,面向 Gemini CLI、Claude Code、Codex、Qwen Code 等多生态接入场景。项目以 TypeScript 构建,1.48 万 Stars 反映其在 AI 编程工具链用户中的较高关注度,通常意味着较活跃的使用讨论与迭代需求。其亮点在于对多家模型/CLI 的统一承载与“24/7”工作流导向,降低了切换成本,并强调本地运行带来的隐私与可控性。建议在引入前评估自身环境依赖、资源占用与权限配置,并优先从单一工作流小规模试用。后续若能加强插件化、稳定性与文档/示例沉淀,生态扩展与企业落地空间更大。