burr

用状态机构建可追踪的 AI 决策应用,自托管无忧

Burr 是一个用于构建决策型应用(如聊天机器人、AI 代理、模拟系统等)的 Python 框架。它解决了开发者在构建复杂状态机驱动的应用时,缺乏结构化流程管理和可观测性的问题。核心能力包括:将应用逻辑定义为显式的状态机(State Machine),支持步骤间的状态转换和持久化;提供内置的监控、追踪和调试工具,可实时查看应用运行轨迹;支持在自有基础设施上执行和部署,不依赖特定云服务。Burr 强调从原型到生产的平滑过渡,帮助开发者清晰管理应用状态、简化调试,并确保每次决策可追溯。

开源 free 基础设施
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2553
维护状态 活跃
是否开源
定价模式 free

项目数据

分类基础设施
开发团队apache
所属国家
定价模式free
价格说明开源项目,Apache-2.0 许可证,可免费使用和自行部署。
访问状态
是否开源
开源协议Apache-2.0
主要语言Python
技术栈/模型ai,burr,chatbot-framework,dags,generative-ai,graphs,hacktoberfest,llmops,llms,mlops,persistent-data-structure,state-machine,state-management,visibility
GitHub 星标★ 2553
30天Star增速
HF 下载量
上线时间2024-01-29 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 5 步

环境要求

  • 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 可看演示应用。

关键配置

配置项必填说明示例
OPENAI_API_KEY设置后 UI 中的 chatbot 演示才能实际对话,不设置也可浏览 UIsk-xxxxxxxxxxxxxxxx

如何确认成功

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

常见问题

Q:安装时提示 Python 版本不满足怎么办?

A:0.43.0 起 [start]、[learn]、[cli] 附带的 CLI 需要 Python 3.10+,核心库仍兼容 Python 3.9;可升级 Python 或只安装核心库。

Q:UI 里的 chatbot 演示无法聊天?

A:需要设置 OPENAI_API_KEY 环境变量才能真正对话;没有 API Key 也能打开演示查看 UI 捕获的内容。

Q:我用 poetry 管理依赖怎么装?

A:README 指向官方文档的安装页(burr.apache.org/getting_started/install/),请按该页说明操作。

Q:需要部署到云服务吗?

A:不需要。Burr 支持在自有基础设施上执行和部署,不依赖特定云服务。

注意事项

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

核心亮点

  • 显式状态机模型,让复杂决策流程清晰可控
  • 内置追踪与监控,实时查看每次决策路径
  • 支持状态持久化,应用重启后无缝恢复

不足之处

  • 文档/社区待观察
  • 状态机概念对简单场景可能过于复杂

适用场景

  • 构建需要多步骤决策的聊天机器人或客服代理
  • 开发可追踪的模拟系统或游戏 AI
  • 在私有云或本地环境部署需要审计的自动化流程

替代项目

LangGraph、Temporal、Prefect

项目介绍

burr 是开发框架领域的开源项目,由 apache 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(2,553)位列前 30%,在开发框架分类中处于中上游。

近 42 天,它的 GitHub 星标从 2,509 增加到 2,553,净增 44。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。Apache-2.0 许可证,可免费使用和自行部署。

它主要面向的使用场景是:构建需要多步骤决策的聊天机器人或客服代理。同类可对比的替代方案包括 LangGraph、Temporal、Prefect。

上一篇:goal-flow

下一篇:Lynkr

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12