Braidrun のワークフローエンジンと SDK をオープンソースで公開
Apache-2.0 のワークフローエンジンを自身の環境で実行し、13 の公式 SDK クライアントを使って既存のアプリケーションから Braidrun クラウドプラットフォームに接続できます。どちらも GitHub でソースコードを公開しており、同じワークフロー機能につながります。
braidrun-workflow：オープンなワークフローランタイム
YAML で定義した AI ワークフローを、コマンドラインからでも Kotlin コードからでも実行できるエンジン。クラウドプラットフォームが裏側で動かしているものと同じランタイムです。
オープンソースリポジトリには、完全なワークフロー実行エンジンとコマンドラインツールが含まれています。YAML で定義したステップ（Agent、コード、ツール呼び出し、サブワークフロー）を順に実行し、本番環境では Docker サブプロセスで分離します。
- YAML でワークフローを定義し、CLI でも Kotlin コードでも実行可能
- Agent ステップ、コードステップ、並列処理、条件分岐、反復、リトライ、ステートマシン、サブワークフロー
- コーディング、リサーチ、ライティング、データ分析、ドキュメント、ブラウザなど多様な Agent プリセットを内蔵
- ファイル、Shell、Git、HTTP、ブラウザ、ドキュメント、データベース、RAG、メールなどのツールグループ
- Claude Code や OpenAI Codex のサブプロセスを通じて外部のコーディング Agent に委任
- ローカル開発にはネイティブサブプロセス、本番の分離には Docker サブプロセス
- Koog を通じて Anthropic、OpenAI、DeepSeek、OpenRouter、Z.ai、NVIDIA などのモデルを統合
- MCP サーバーとして動作し、ツールグループを他のクライアントに公開可能
# コマンドラインツールをビルド
./gradlew installDist
# examples ディレクトリに付属のサンプルを検証して実行
./build/install/braidrun-workflow/bin/braidrun-workflow run \
examples/workflows/research-summary.yamlname: research-summary
version: 1.0.0
description: Simple LLM-backed workflow using the researcher preset.
agents:
researcher:
preset: researcher
overrides:
max_iterations: 32
workflow:
- step: summarize
agent: researcher
input: "Explain what Braidrun Workflow is and list three use cases."braidrun-sdk：使い慣れた言語で Braidrun に接続
12 言語をカバーする 13 のタイプセーフなクライアントが、オープンプラットフォーム API を使い慣れたメソッド、モデル、エラー型として提供します。
SDK を使うと、既存のアプリケーションから Braidrun クラウドプラットフォームを呼び出し、ワークフローの開始、実行結果の確認、成果物の取得、人による承認、Webhook 連携を行えます。すべてのクライアントは同じ OpenAPI 定義から生成され、インターフェースとデータモデルの一貫性が保たれます。
- ワークフローを検索し、非同期で実行を開始
- 実行状態、最終結果、成果物を取得し、実行中の処理をキャンセル
- 人による承認を確認、承認、却下し、Webhook を管理・実行
- Bearer、X-API-Key、権限スコープに対応した型付き API とデータモデル
- 各言語のディレクトリに、インストール、設定、エンドポイント、モデルのドキュメントを収録
コマンドラインツールとして、または自分のプロジェクトに組み込んで
同じパーサーと実行エンジンを、ターミナルで直接実行することも、Kotlin/JVM ライブラリとして依存関係に加えることもできます。
ビルドすると braidrun-workflow コマンドが手に入り、ワークフローの検証・試験実行・実行ができます。ワークフローファイルを書かずに単一のプリセット Agent を直接実行することも可能です。スクリプト化や自動化パイプラインに最適です。
braidrun-workflow agent \
--preset researcher \
--prompt "このリポジトリを要約し、3つのユースケースを挙げる"- run / validate / dry-run で実行と検証をカバー
- list-presets、list-tools で組み込み機能を確認
- mcp-server でツールグループを MCP サーバーとして公開
リリース版は JitPack 経由で配布されます。依存関係を1行加えるだけで、自分の JVM アプリケーションから WorkflowParser と WorkflowExecutor を呼び出せます。CLI とまったく同じ実装です。
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser · WorkflowExecutor をそのまま利用可能
- 開発にはネイティブサブプロセス、本番には Docker サブプロセス
- JDK 21 以上が必要。Docker 分離モードには Docker が必要
オープンソース版はエンジンを、クラウドプラットフォームは作業環境一式を提供
どちらも同じランタイムを共有しています。以下では、オープンソース版に標準で備わる機能と、クラウドプラットフォームがその上に追加する機能を1行ずつ説明します。
| 機能 | オープンソース版braidrun-workflow | クラウドプラットフォームbraidrun.com |
|---|---|---|
| ワークフロー実行エンジン（YAML） | ✓自分でデプロイして実行 | ✓同じエンジンをホスティングで実行 |
| CLI とライブラリ統合 | ✓CLI と Kotlin/JVM ライブラリ | ✓公式 SDK または REST API で接続 |
| ビジュアルエディター（キャンバス ⇄ YAML） | —UI なし、YAML を編集 | ✓キャンバスと YAML を双方向同期 |
| 対話型 AI アシスタントでワークフローを構築 | —提供なし | ✓対話でワークフローを生成・編集 |
| ブレークポイントデバッグと失敗ステップの再実行 | —自分でデバッグ | ✓ブレークポイントで値を変更して再開でき、完了済みステップは再課金されません |
| サービス再起動後の自動再開 | —自分で実装 | ✓定義ハッシュを検証してから自動復旧 |
| 実行履歴とモニタリング | △ログは自前で構築 | ✓実行履歴、コスト計算、アラート |
| テンプレートとモジュール | △リポジトリに少数のサンプルを同梱 | ✓240+ テンプレート、120+ モジュールとマーケットプレイス |
| 人による承認ゲート | △ランタイムでサポート、通知は自前で構築 | ✓アプリ内 / メール / API 通知 |
| スケジュール / Webhook / API トリガー | △スケジュールは自前で | ✓組み込みトリガーとチェーンスケジューリング |
| チームコラボレーションと権限管理 | —提供なし | ✓チーム、ロール、共有 |
| サンドボックスとシークレット管理 | ✓Docker 分離、自己管理 | ✓ホスト型サンドボックスとシークレット暗号化 |
| テクニカルサポート | —コミュニティのみ、公式サポートなし | ✓専門的なテクニカルサポート |
| プライベートデプロイ | ✓本質的にセルフホスト | ✓エンタープライズ版はプライベートデプロイに対応 |
インフラ管理を減らしてワークフロー構築に集中したいなら
オープンソース版はエンジンをあなた自身で動かすために提供します。クラウドプラットフォームはインターフェース、コラボレーション、ホスティング、サポートをまとめて補い、ワークフローをより速く公開でき、より保守しやすくします。
こんな場合はオープンソース版で十分
誰もがクラウドに移行すべきだとは考えていません。以下の3つのケースでは、オープンソース版そのものが最適な選択です。
エンジン、SDK、クラウドプラットフォームについて
オープンソース版とクラウドプラットフォームは同じエンジンですか？
はい。クラウドプラットフォームは同じオープンソースランタイムの上に構築されており、ビジュアル編集、コラボレーション、実行履歴、モニタリング、ホスト型実行を追加で提供します。オープンソース版で動作した YAML は、ほぼそのままクラウドに移行できます。
braidrun-workflow のライセンスは何ですか？商用利用できますか？
Apache-2.0 ライセンスを採用しており、ライセンスと著作権表示を保持すれば商用利用や改変が可能です。詳しくはリポジトリ内の LICENSE ファイルをご覧ください。
SDK とオープンソースのワークフローエンジンはどう違いますか？
SDK はアプリケーションから Braidrun クラウドプラットフォーム API を呼び出すためのもので、多言語システムの連携に適しています。braidrun-workflow はローカル環境や自社サーバーで実行できるワークフローエンジン兼コマンドラインツールです。
各言語のパッケージマネージャーから SDK を直接インストールできますか？
SDK は現在、GitHub のソースリポジトリから提供しています。各言語のパッケージマネージャーでの公開状況は異なる場合があります。クライアントを選び、該当ディレクトリの README にあるインストール手順に従ってください。
オープンソース版はテクニカルサポートを提供しますか？
オープンソースプロジェクトは公式のテクニカルサポートを提供せず、コミュニティとドキュメントに依存します。担当者による対応やサービスレベルの保証が必要な場合は、クラウドプラットフォームまたはエンタープライズ版をご利用ください。
まずオープンソース版を使い、後からクラウドプラットフォームに移行できますか？
はい。多くのチームはまずコマンドラインでワークフローを検証し、その後クラウドプラットフォームに移行して、ビジュアルインターフェース、コラボレーション、ホスティング機能を利用します。ワークフローは標準の YAML で定義されるため、移行コストはわずかです。
クラウドプラットフォームを使うとロックインされますか？
コアエンジンはオープンソースで、ワークフローは標準の YAML で定義されます。いつでもワークフローをエクスポートしてオープンソース版で自分で実行でき、ロックインの心配はありません。