Repolode
apache

apache/burr

チャットボットやエージェントなどの意思決定アプリケーションをステートマシンとして構築し、トレースと監視用のUIも備えたPythonライブラリ。

スター
2,576
フォーク
208
未解決の Issue
104
最終コミット
昨日

これは何?

Apache Burrでは、遷移でつながったアクションのグラフであるステートマシンとして、アプリケーションを表現できます。各アクションは、共有状態を読み書きする通常のPython関数です。そのため、メモリの管理、分岐した判断の追跡、人によるフィードバックの挿入、保存した時点からのワークフロー再開を簡単に行えます。

コアライブラリに依存関係はありません。Burrは特定のフレームワークに依存せず、あらゆるLLMやPythonライブラリと連携できるため、OpenAI形式のAPI呼び出しをラップしたり、Apache Hamiltonなどのツールに処理を委任したりできます。プラグイン可能なpersisterでアプリケーションの状態を保存・読み込みでき、hooksを使って可観測性ベンダーと連携できます。

Burrには実行状況をリアルタイムで追跡するWeb UIも付属しており、開発者はトレースを確認して各ステップをデバッグできます。チャットボット、LLMエージェント、シミュレーション、その他のLLMを使わない処理を対象としており、独自のインフラ上で実行できます。

主な機能

  • 01通常のPython関数からステートマシンとしてアプリケーションを構築
  • 02プラグイン可能なpersisterを使ったアプリケーション状態の保存と読み込み
  • 03実行をリアルタイムでトレース・監視する組み込みUI
  • 04あらゆるLLMやPythonフレームワークと連携できる、依存関係のないコアライブラリ
  • 05可観測性およびストレージベンダーと連携するためのhooks

ユースケース

  • 会話履歴を記憶するステートフルなチャットボットの構築
  • 分岐ロジックやhuman-in-the-loopのステップを備えたLLMエージェントの開発
  • ビジュアルUIで複数ステップからなるAIワークフローをデバッグ・トレース
  • シミュレーションやハイパーパラメータ調整のワークフローをステートマシンとして実行

クイックスタート

  1. 1

    start extras を指定して PyPI から Burr をインストールする

    pip install "apache-burr[start]"
  2. 2

    Burr UI サーバーを起動する

    burr
  3. 3

    リポジトリをクローンして、hello-world カウンターの例を実行する

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

    カウンターのサンプルアプリケーションを実行する

    python application.py

使う前に知っておきたいこと

  • チャットボットのデモで実際にチャットするには OPENAI_API_KEY が必要ですが、キーがなくても UI は動作します。
  • README によると、非同期のイベントベースのオーケストレーションとホスト型実行はまだ利用できず、Burr Cloud はウェイトリストへの登録受付中です。

収録されている特集

トピック

よくある質問

burr とは?
チャットボットやエージェントなどの意思決定アプリケーションをステートマシンとして構築し、トレースと監視用のUIも備えたPythonライブラリ。 Apache Burrでは、遷移でつながったアクションのグラフであるステートマシンとして、アプリケーションを表現できます。各アクションは、共有状態を読み書きする通常のPython関数です。そのため、メモリの管理、分岐した判断の追跡、人によるフィードバックの挿入、保存した時点からのワークフロー再開を簡単に行えます。
burr は無料で使えますか?ライセンスは?
burr は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
burr は今もメンテナンスされていますか?
活発にメンテナンス中。burr の最終コミットは 2026年10月21日 です。
burr は何に使えますか?
会話履歴を記憶するステートフルなチャットボットの構築 分岐ロジックやhuman-in-the-loopのステップを備えたLLMエージェントの開発 ビジュアルUIで複数ステップからなるAIワークフローをデバッグ・トレース シミュレーションやハイパーパラメータ調整のワークフローをステートマシンとして実行
burr のインストール方法は?
start extras を指定して PyPI から Burr をインストールする: pip install "apache-burr[start]" Burr UI サーバーを起動する: burr リポジトリをクローンして、hello-world カウンターの例を実行する: git clone https://github.com/apache/burr && cd burr/examples/hello-world-counter カウンターのサンプルアプリケーションを実行する: python application.py
burr はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/apache/burr

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト