Braidrun 的工作流程引擎與 SDK 已開放原始碼
使用 Apache-2.0 工作流程引擎在自己的環境中執行，並透過 13 個官方 SDK 用戶端，從現有應用程式接入 Braidrun 雲端平台。兩條路徑都在 GitHub 公開原始碼，也都連接同一套工作流程能力。
braidrun-workflow：開放的工作流執行環境
一個用 YAML 定義、可從命令列或 Kotlin 程式碼執行 AI 工作流的引擎，與雲端平台背後跑的是同一套執行環境。
開源儲存庫包含完整的工作流執行引擎和命令列工具。它按 YAML 裡定義的步驟依序執行 Agent、程式碼、工具呼叫與子工作流，並在生產環境用 Docker 子行程做隔離。
- YAML 定義工作流，命令列或 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
13 個型別安全用戶端涵蓋 12 種語言，將開放平台 API 轉換成你的技術堆疊所熟悉的方法、模型與錯誤類型。
SDK 可讓現有應用程式呼叫 Braidrun 雲端平台：啟動工作流程、查詢執行結果、讀取產物、處理人工審批，以及接入 Webhook。所有用戶端均由同一份 OpenAPI 描述產生，介面與資料模型保持一致。
- 查詢工作流程並非同步啟動執行
- 讀取執行狀態、最終結果與產物，並取消執行中的任務
- 查詢、核准或拒絕人工審批，以及管理並觸發 Webhook
- 具型別的 API 與資料模型，支援 Bearer、X-API-Key 與權限 scope
- 每個語言目錄均附有安裝、設定、端點與模型文件
當命令列工具，或嵌入你自己的專案
同一套解析器和執行器，既能在終端機裡直接跑，也能作為 Kotlin/JVM 函式庫依賴。
建置後得到一個 braidrun-workflow 命令，可以驗證、試執行和執行工作流，也能不寫工作流檔案直接跑單一預設 Agent。適合指令碼化與自動化管線。
braidrun-workflow agent \
--preset researcher \
--prompt "總結這個儲存庫並列出三個使用情境"- run / validate / dry-run 涵蓋執行與驗證
- list-presets、list-tools 查看內建能力
- mcp-server 把工具組暴露為 MCP 伺服器
發布的版本透過 JitPack 散布，加一行依賴就能在自己的 JVM 應用裡呼叫 WorkflowParser 與 WorkflowExecutor，用的是和命令列完全相同的實作。
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser · WorkflowExecutor 直接可用
- 原生子行程用於開發，Docker 子行程用於生產
- 需要 JDK 21 及以上；Docker 隔離模式需要 Docker
開源版給你引擎，雲端平台給你整套工作台
兩邊共用同一個執行環境。下面逐行說明：哪些能力開源版自帶，哪些是雲端平台在其之上補齊的。
| 能力 | 開源版braidrun-workflow | 雲端平台braidrun.com |
|---|---|---|
| 工作流執行引擎（YAML） | ✓自行部署執行 | ✓同一套引擎，託管執行 |
| 命令列與函式庫整合 | ✓CLI 加 Kotlin/JVM 函式庫 | ✓透過官方 SDK 或 REST API 接入 |
| 視覺化編輯器（畫布 ⇄ YAML） | —無介面，改 YAML | ✓畫布與 YAML 雙向同步 |
| 對話式 AI 助手搭流程 | —不提供 | ✓對話生成與修改工作流 |
| 中斷點除錯與失敗重跑 | —自行排查 | ✓中斷點改值續跑，已完成步驟不重複計費 |
| 服務重啟自動續跑 | —自行實作 | ✓驗證定義雜湊後自動恢復 |
| 執行歷史與監控 | △自建日誌 | ✓執行歷史、成本核算與告警 |
| 範本與模組 | △儲存庫自帶少量範例 | ✓240+ 範本、120+ 模組與市集 |
| 人工審批門控 | △執行環境支援，需自建通知 | ✓應用內 / 郵件 / API 通知 |
| 定時 / Webhook / API 觸發 | △自行排程 | ✓內建觸發與鏈式排程 |
| 團隊協作與權限 | —不提供 | ✓團隊、角色與共享 |
| 沙箱與金鑰管理 | ✓Docker 隔離，自行管理 | ✓託管沙箱加金鑰加密 |
| 技術支援 | —社群，無官方支援 | ✓專業技術支援 |
| 私有化部署 | ✓本身即自行託管 | ✓企業版支援私有化 |
如果你想少管環境、多做流程
開源版把引擎交給你自己跑；雲端平台把介面、協作、託管和支援一併補齊，讓流程更快上線、更好維護。
這些情況，用開源版就夠了
我們不覺得每個人都該上雲。下面三種情境，開源版本身就是最合適的選擇。
關於引擎、SDK 與雲端平台
開源版和雲端平台是同一套引擎嗎？
是。雲端平台建構在同一個開源執行環境之上，額外提供視覺化編輯、協作、執行歷史、監控與託管執行。你在開源版裡跑通的 YAML，幾乎可以原樣搬到雲端平台。
braidrun-workflow 採用什麼授權條款？可以商用嗎？
採用 Apache-2.0 授權，允許商用與二次開發，保留授權條款與版權聲明即可。詳見儲存庫中的 LICENSE 檔案。
SDK 與開源工作流程引擎有什麼差異？
SDK 用於從你的應用程式呼叫 Braidrun 雲端平台 API，適合多語言系統整合；braidrun-workflow 則是可在本機或自有伺服器執行的工作流程引擎與命令列工具。
SDK 可以直接從各語言的套件管理器安裝嗎？
SDK 目前統一透過 GitHub 原始碼儲存庫提供，各語言套件管理器的發布狀態可能不同。選擇用戶端後，請依照對應目錄 README 的安裝說明操作。
開源版提供技術支援嗎？
開源專案不提供官方技術支援，依靠社群與文件。如果你需要專人回應和服務等級承諾，請使用雲端平台或企業版。
我可以先用開源版，之後再遷移到雲端平台嗎？
可以。很多團隊先用命令列驗證流程，再把工作流搬到雲端平台，獲得視覺化介面、協作與託管能力。工作流用標準 YAML 定義，遷移成本很低。
用了雲端平台會被鎖定嗎？
核心引擎是開源的，工作流用標準 YAML 定義。你隨時可以匯出工作流，在開源版裡自行執行，不存在被鎖定的問題。