Braidrun 워크플로 엔진과 SDK 소스 공개
Apache-2.0 워크플로 엔진을 자체 환경에서 실행하고, 13개의 공식 SDK 클라이언트로 기존 애플리케이션을 Braidrun 클라우드 플랫폼에 연동할 수 있습니다. 두 경로 모두 GitHub에 소스가 공개되어 있으며 동일한 워크플로 기능을 사용합니다.
braidrun-workflow: 개방형 워크플로 런타임
YAML로 정의하고 명령줄이나 Kotlin 코드에서 실행할 수 있는 AI 워크플로 엔진으로, 클라우드 플랫폼이 뒤에서 구동하는 것과 동일한 런타임입니다.
오픈소스 저장소에는 완전한 워크플로 실행 엔진과 명령줄 도구가 포함되어 있습니다. YAML에 정의된 단계에 따라 에이전트, 코드, 도구 호출, 하위 워크플로를 순서대로 실행하며, 프로덕션 환경에서는 Docker 서브프로세스로 격리합니다.
- YAML로 워크플로를 정의하고 명령줄이나 Kotlin 코드에서 실행
- 에이전트 단계, 코드 단계, 병렬 처리, 조건, 반복, 재시도, 상태 머신, 하위 워크플로
- 코딩, 리서치, 글쓰기, 데이터 분석, 문서, 브라우저 등 다양한 에이전트 프리셋 내장
- 파일, Shell, Git, HTTP, 브라우저, 문서, 데이터베이스, RAG, 이메일 등 도구 그룹
- Claude Code와 OpenAI Codex 서브프로세스를 통해 외부 코딩 에이전트에 위임
- 로컬 개발에는 네이티브 서브프로세스, 프로덕션 격리에는 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 명령이 생성되어 워크플로를 검증하고 dry-run으로 시험 실행하고 실행할 수 있으며, 워크플로 파일 없이 단일 프리셋 에이전트를 바로 실행할 수도 있습니다. 스크립트화와 자동화 파이프라인에 적합합니다.
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) | —UI 없음, YAML 편집 | ✓캔버스와 YAML 양방향 동기화 |
| 워크플로를 구성하는 대화형 AI 어시스턴트 | —제공 안 함 | ✓대화로 워크플로 생성 및 수정 |
| 중단점 디버깅 및 실패 단계 재실행 | —직접 디버깅 | ✓중단점에서 값을 변경하고 이어서 실행, 완료된 단계는 재청구되지 않음 |
| 서비스 재시작 후 자동 재개 | —직접 구현 | ✓정의 해시를 검증한 후 자동 복구 |
| 실행 기록 및 모니터링 | △직접 로깅 구축 | ✓실행 기록, 비용 정산 및 알림 |
| 템플릿과 모듈 | △저장소에 포함된 소수의 예제 | ✓240+ 템플릿, 120+ 모듈 및 마켓플레이스 |
| 사람 승인 게이트 | △런타임 지원, 알림은 직접 구축 필요 | ✓앱 내 / 이메일 / API 알림 |
| 예약 / Webhook / API 트리거 | △직접 스케줄링 | ✓내장 트리거 및 체인 스케줄링 |
| 팀 협업 및 권한 | —제공 안 함 | ✓팀, 역할 및 공유 |
| 샌드박스 및 시크릿 관리 | ✓Docker 격리, 직접 관리 | ✓호스팅 샌드박스 및 시크릿 암호화 |
| 기술 지원 | —커뮤니티만, 공식 지원 없음 | ✓전문 기술 지원 |
| 프라이빗 배포 | ✓본질적으로 셀프 호스팅 | ✓엔터프라이즈 버전은 프라이빗 배포 지원 |
환경 관리는 줄이고 워크플로 구축에 집중하고 싶다면
오픈소스 버전은 엔진을 직접 실행하도록 넘겨주고, 클라우드 플랫폼은 인터페이스, 협업, 호스팅, 지원을 함께 갖춰 워크플로를 더 빠르게 출시하고 더 쉽게 유지관리하도록 합니다.
이런 경우라면 오픈소스 버전으로 충분합니다
모두가 클라우드로 이동해야 한다고 생각하지는 않습니다. 아래 세 가지 경우에는 오픈소스 버전 자체가 가장 적합한 선택입니다.
엔진, SDK 및 클라우드 플랫폼 안내
오픈소스 버전과 클라우드 플랫폼은 동일한 엔진인가요?
네. 클라우드 플랫폼은 동일한 오픈소스 런타임 위에 구축되어 시각적 편집, 협업, 실행 기록, 모니터링, 호스팅 실행을 추가로 제공합니다. 오픈소스 버전에서 동작시킨 YAML은 거의 그대로 클라우드 플랫폼으로 옮길 수 있습니다.
braidrun-workflow는 어떤 라이선스를 사용하나요? 상업적으로 사용할 수 있나요?
Apache-2.0 라이선스를 채택하여 라이선스와 저작권 고지를 유지하는 한 상업적 사용과 2차 개발을 허용합니다. 자세한 내용은 저장소의 LICENSE 파일을 참조하세요.
SDK와 오픈 소스 워크플로 엔진의 차이점은 무엇인가요?
SDK는 애플리케이션에서 Braidrun 클라우드 플랫폼 API를 호출하기 위한 것으로 다국어 시스템 연동에 적합합니다. braidrun-workflow는 로컬 또는 자체 서버에서 실행할 수 있는 워크플로 엔진이자 명령줄 도구입니다.
각 언어의 패키지 관리자에서 SDK를 바로 설치할 수 있나요?
SDK는 현재 GitHub 소스 저장소를 통해 제공되며 언어별 패키지 관리자의 배포 상태는 서로 다를 수 있습니다. 클라이언트를 선택한 후 해당 디렉터리의 README에 있는 설치 지침을 따르세요.
오픈소스 버전은 기술 지원을 제공하나요?
오픈소스 프로젝트는 공식 기술 지원을 제공하지 않으며 커뮤니티와 문서에 의존합니다. 전담 응대와 서비스 수준 약정이 필요하다면 클라우드 플랫폼이나 엔터프라이즈 버전을 이용하세요.
먼저 오픈소스 버전을 사용하다가 나중에 클라우드 플랫폼으로 마이그레이션할 수 있나요?
네. 많은 팀이 먼저 명령줄에서 프로세스를 검증한 후 워크플로를 클라우드 플랫폼으로 옮겨 시각적 인터페이스, 협업, 호스팅 기능을 활용합니다. 워크플로는 표준 YAML로 정의되므로 마이그레이션 비용이 매우 낮습니다.
클라우드 플랫폼을 사용하면 종속되나요?
핵심 엔진은 오픈소스이며 워크플로는 표준 YAML로 정의됩니다. 언제든지 워크플로를 내보내 오픈소스 버전에서 직접 실행할 수 있으므로 종속 문제가 없습니다.