burr

环境要求

• Python 已安装（核心库支持 Python 3.9+）
• 若使用 [start]/[learn]/[cli] 附带的 CLI，需要 Python 3.10+
• 已安装 pip，可执行 pip install
• 本地已安装 git（运行示例时需要克隆仓库）
• 可选：OPENAI_API_KEY 环境变量，用于 UI 里的 chatbot 演示

安装与启动步骤

1. 1安装 Burr

   用 pip 从 PyPI 安装 apache-burr，[start] 会一并装上可选的 CLI 与学习组件，注意需要联网。

   pip install "apache-burr[start]"

   复制

2. 2启动 UI 服务

   运行 burr 命令会打开遥测 UI，内置默认数据可直接点击浏览，包含演示用 chat 应用。

   burr

   复制

3. 3克隆仓库

   把官方仓库克隆到本地并进入 hello-world-counter 示例目录，为下一步运行做准备。

   git clone https://github.com/apache/burr && cd burr/examples/hello-world-counter

   复制

4. 4运行计数器示例

   执行示例入口脚本，终端会打印 counter 的运行过程，同时轨迹会被 UI 记录。

   python application.py

   复制

5. 5在 UI 中查看轨迹

   回到 Burr UI，尝试找到刚才这次 counter 运行的 trace；左侧 Demos 选 chatbot 可看演示应用。

关键配置

如何确认成功

终端能打印出 counter 示例的运行输出，且在 Burr UI 中能看到对应的 trace 记录，即表示安装与运行成功。

常见问题

注意事项

• CLI 组件（[start]/[learn]/[cli]）自 0.43.0 起要求 Python 3.10+，核心库兼容 3.9。
• 项目处于 Apache incubating 孵化阶段，接口可能有变化。
• 更多细节参见官方 getting started 指南与文档站 burr.apache.org。