bub

用钩子机制精细控制 AI 代理，让人机协作更安全可靠

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 168 🐛 待处理 1 👀 关注 6

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1700

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队bubbuild

官网地址https://bub.build

GitHubhttps://github.com/bubbuild/bub

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agent-framework,agent-skills,ai-agents,cli,context-engineering,harness,plugins,python,self-hosted

GitHub 星标★ 1700

上线时间2025-07-13 00:00:00

代码更新2026-11-05

仓库体积6.0 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

Bub 是一个以钩子（hook）为核心的智能体运行时，专为与人类协作共存的 AI 代理设计。它解决的是传统智能体框架中代理行为难以精细控制和与用户实时交互的问题。其核心能力包括：通过钩子机制在代理执行的关键节点（如工具调用、消息生成）注入自定义逻辑，实现实时干预、权限控制和状态追踪；支持长时运行的任务，代理可以暂停、恢复，并持久化状态；提供简洁的 Python API，便于开发者快速构建和部署。Bub 强调代理与人的共生关系，让代理不仅能自主执行任务，还能在需要时请求人类确认或反馈，从而提升任务完成的安全性和可靠性。项目处于成长阶段，社区活跃，适合探索下一代人机协作代理的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1700

技术标签

agent-framework agent-skills ai-agents cli context-engineering

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

macOS、Linux 或 Windows 系统（提供对应安装脚本）
需要能访问网络的终端（下载安装脚本与依赖）
从源码安装需要 git 与 uv 工具链
使用模型服务需要对应的 API Key（可选，也可用 bub login openai）

安装与启动步骤

1一键安装（macOS/Linux）

官方交互式安装脚本，会提供预设选择器、可追加插件依赖，并在安装后自动执行 bub onboard 引导。
```
curl -fsSL https://bub.build/install.sh | bash
```
2一键安装（Windows）

Windows 用户在 PowerShell 中执行对应安装脚本，效果与 macOS/Linux 安装脚本一致。
```
powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"
```
3非交互式安装

自动化场景需显式指定 preset；非交互安装会跳过 onboard 引导，可用 --dependency 追加插件。
```
curl -fsSL https://bub.build/install.sh | bash -s -- --preset recommended --dependency extra-plugin
```
4从源码安装

克隆仓库后进入目录，用 uv sync 同步依赖即可从源码运行 Bub；本地开发可改用 make install。
```
git clone https://github.com/bubbuild/bub.git
cd bub
uv sync
```
5配置模型与密钥

通过环境变量指定模型与 API Key，默认模型为 openrouter:openrouter/free；也可用 bub login openai 登录。
```
export BUB_MODEL=openrouter:openrouter/free
export BUB_API_KEY=sk-xxxxxxxx
```
6启动交互会话

运行 bub chat 进入交互式对话，可直接验证安装与模型配置是否生效。
```
bub chat
```
7执行一次性任务

用 bub run 加上任务描述，让代理完成单次任务后返回结果。
```
bub run "summarize this repo"
```
8启动频道监听

以 bub gateway 运行频道监听模式，同一运行时也可驱动 Telegram 等自定义频道。
```
bub gateway
```

关键配置

配置项	必填	说明	示例
`BUB_MODEL`	否	模型标识符，默认 openrouter:openrouter/free	`openrouter:openrouter/free`
`BUB_API_KEY`	否	模型服务商密钥，使用 bub login openai 时可省略	`sk-xxxxxxxx`
`BUB_API_BASE`	否	自定义模型服务商端点地址	`https://api.openai.com/v1`
`BUB_CLIENT_ARGS`	否	转发给底层模型客户端的 JSON 对象	`{"timeout":30}`
`BUB_MAX_STEPS`	否	工具调用循环上限，必须为正整数，默认不限	`20`
`BUB_MAX_TOKENS`	否	单次模型调用的最大 token 数，默认 16384	`16384`