跳转到内容
Bub Bub Bub

安装 Bub

按你的使用方式选择安装路径。Python 项目通过 uv 添加 Bub；运行应用可以使用安装脚本或 uv。

构建自己的 Agent

Section titled “构建自己的 Agent”

使用 Python 3.12 或更高版本，在项目中添加 Bub：

uv add bub
uv run python -c "from bub.core import Agent; print(Agent.__name__)"

如果还没有项目，先运行 uv init --python 3.12 my-agent，再进入 cd my-agent。

基础安装包含内核所需的 Republic、Pydantic、Loguru 和 typing-extensions。导入检查无需模型凭据。接着阅读构建自己的 Agent，在 Python 中配置模型并运行第一个示例。

运行 Bub 应用

Section titled “运行 Bub 应用”

选择适合你的安装方式：

curl -fsSL https://bub.build/install.sh | bash

脚本会按需安装 uv 和 Python 3.12，并将 bub[app] 安装到 ~/.bub/.venv。按提示选择插件预设，再完成模型和渠道配置。

安装结束后，确认命令目录已加入 PATH，再检查：

bub --help

接着阅读首次运行 Bub，在自己的工作区开始对话。

基础安装与 bub[app] 包含相同的包文件；extra 改变的是安装的依赖。缺少应用依赖时，bub 命令会退出，并提示安装 bub[app]。

在虚拟环境中开发应用

Section titled “在虚拟环境中开发应用”

开发插件或添加追踪导出器等包时，可以创建并激活一个虚拟环境：

uv venv --python 3.12
source .venv/bin/activate
uv pip install "bub[app]"
bub --help

PowerShell 中的激活命令为 .\.venv\Scripts\Activate.ps1。在同一个环境中运行应用并安装扩展。如果项目已经使用 uv，也可以通过 uv add 添加 "bub[app]"，再用 uv run bub 运行命令。

声明包依赖

Section titled “声明包依赖”

把依赖添加到项目 pyproject.toml 已有的 [project] 表。直接使用 Agent 的包声明：

requires-python = ">=3.12"
dependencies = ["bub>=0.6.0"]

如果包会导入内置 Agent、Framework、插件、skills 或渠道，则声明：

dependencies = ["bub[app]>=0.6.0"]

修改依赖后，同步项目环境。现有应用更新依赖时，参照升级到 0.6.0。

从源码参与开发

Section titled “从源码参与开发”

为 Bub 本身贡献代码时，克隆仓库：

git clone https://github.com/bubbuild/bub.git
cd bub
uv sync

uv sync 会安装开发依赖组，其中包含应用依赖和 Python 检查工具。之后可以使用 uv run bub 和仓库的测试命令。