avibe
avibe-bot/avibe加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
"你的 AI agent 很强——但被困住了。" 这句写在项目 README 开头的痛点，精准概括了 2025 年 AI 开发者的集体困境：Claude Code、Codex、OpenCode 们虽然能力强大，但它们活在终端里、困在一台机器上、够不着也管不住。Avibe 正是为解决这个问题而生——一条命令，把你自己的机器变成 AI 伙伴的家。
想象这样的场景：你在咖啡馆里用手机突然想起来，早上出门前让 Claude Code 跑的那个代码重构不知道结果怎么样了——但它在你家里的台式机上，台式机的终端还开着。可你什么都看不到，也没法干预，只能干等回家。
又或者，你同时在做一个前端项目和一个后端项目，分别用 Claude Code 和 OpenCode 来辅助开发。但两个工具各管各的，它们的会话、上下文、技能库完全隔离，你要在两个终端之间来回切换，还要手动复制粘贴上下文。
这两个场景，一个是可达性问题，一个是统一管理问题。Avibe 的作者 @cyhhao（GitHub: cyhhao）正是带着这两个真实痛点，开发了 Avibe，并在 README 中坦诚写道："这个项目从头到尾都是我用 Avibe 本身开发的。"
Avibe 的定位不是又一个 AI 聊天工具，而是一个本地优先的 Agent 操作系统（Agent OS）。它自己不训练模型，也不提供模型，而是扮演一个"调度层"——把 Claude Code、OpenCode、Codex 这三个业界最主流的 Agent CLI 工具聚合到一个统一的界面后面，让用户可以用任何设备、任何渠道来操控它们。
核心架构由三层构成：
Agent Harness（代理调度引擎）：给每个 Agent 赋予持久化能力——run（运行）、schedule（定时）、watch（监听文件变化）、inspect（回溯历史）。这让 Agent 不再只是"你打字它才动"的被动工具，而是可以后台持续运转、主动汇报的智能伙伴。
Workbench（工作台）：一个基于浏览器的多窗口界面，聊天、文件浏览、代码编辑、终端四个模块并排展开，内置应用和 Agent 生成的 Show Pages 也能并排显示。你可以在浏览器里直接操作本地 Agent，而不需要盯着终端的黑窗口。
Messaging Hub（消息中枢）：打通 Slack、Discord、Telegram、飞书/Lark、微信五大 IM 平台，同一个 Agent 可以通过不同 IM 工具来触发和对话。
bash -o pipefail -c 'curl -fsSL https://avibe.bot/install.sh | bash -s -- --launch'
运行这条命令后，浏览器自动打开，跟着向导配置好 API Key（支持 Anthropic、OpenAI、OpenAI 兼容接口），你的机器就成了一个可远程访问的 Agent OS。
如果想远程访问（不在同一局域网、甚至在外网），运行 vibe remote 命令，Avibe 会通过 avibe.bot 隧道建立加密连接，分配一个临时 URL——无需公网 IP，无需内网穿透工具。
图：Workbench 主界面——多窗口并排，聊天与执行历史一目了然
从代码结构来看，Avibe 是一个典型的前后端分离 + 本地 Agent 运行时架构：
storage/ 目录），Vault 模块处理密钥托管项目采用 hatch + hatch-vcs 构建，打包为 vibe CLI 命令。容器化方面，提供了完整的多阶段 Dockerfile（前端 Node 构建 + 后端 Python 运行），以及 docker-compose.e2e.yml 方便测试。
图：Workbench 内置应用库，同时打开文件浏览器、终端和代码编辑器
Agent Harness 是 Avibe 最独特的设计。它为每个 Agent 提供了四种持久化原语：
每条任务详情面板会展示：触发条件、所属 Agent、所属 Session、结果投递方式以及完整的执行历史。
图：Harness 任务列表，展示调度时间、Agent 归属和执行状态
Show Pages 是另一个杀手级功能。当 Agent 生成的内容是图表、流程图或小型 Web 应用时，它会将结果渲染为可交互的在线页面，用户可以在页面上直接评论，Agent 根据评论位置重新生成内容。
图：Show Page 支持在页面上直接评论，Agent 根据锚点位置精准修改对应区域
门槛适中。 对 AI 爱好者来说，官方一键安装脚本和 Web UI 已经极大降低了使用难度。但需要注意的是：
avibe-memory 提供了更长期的知识记忆能力局限性方面，Avibe 本质上是一个编排层，依赖于 Claude Code、Codex、OpenCode 本身的更新；作为相对年轻的项目（2025 年 8 月创建），其生态仍在早期阶段。
Avibe 的出现呼应了 2025 年 AI 工具领域的一个重要趋势：本地优先（Local-First）。随着用户对数据隐私和云服务锁定的担忧加剧，Avibe 不追求替代任何一个 Agent 工具，而是做一个"通用的遥控器"，把选择权还给用户。
从技术角度看，Avibe 展现了如何用 Python 构建一个生产级的 Agent 调度平台：模块化设计（core/ + modules/ + vibe/ 分层）、完整的数据库迁移（SQLAlchemy + Alembic）、容器化部署（多阶段 Dockerfile）、以及质量保障（pre-commit 钩子、回归测试套件）。
| 项目 | 信息 |
|---|---|
| Stars / Forks | ⭐ 499 / 🍴 79 |
| 编程语言 | Python 3.10+（后端） + React 18（前端） |
| 许可证 | MIT |
| 作者 | cyhhao |
| 官网 | https://avibe.bot |
| 创建时间 | 2025 年 8 月 |