Workflow-Engine und SDK von Braidrun sind jetzt Open Source
Betreiben Sie die Workflow-Engine unter Apache-2.0 in Ihrer eigenen Umgebung und binden Sie bestehende Anwendungen über 13 offizielle SDK-Clients an die Braidrun-Cloud-Plattform an. Beide Wege sind als Open Source auf GitHub verfügbar und greifen auf dieselben Workflow-Funktionen zu.
braidrun-workflow: die offene Workflow-Laufzeit
Eine Engine, die in YAML definierte KI-Workflows über die Kommandozeile oder aus Kotlin-Code ausführt — dieselbe Laufzeit, die die Cloud-Plattform im Hintergrund verwendet.
Das Open-Source-Repository enthält die vollständige Workflow-Laufzeit und das Kommandozeilen-Tool. Es führt die in deinem YAML definierten Schritte der Reihe nach aus — Agents, Code, Tool-Aufrufe und Sub-Workflows — und isoliert sie in der Produktion mit Docker-Subprozessen.
- In YAML definierte Workflows, ausführbar über die CLI oder aus Kotlin-Code
- Agent-Schritte, Code-Schritte, Parallelität, Bedingungen, Iteration, Wiederholungsversuche, Zustandsautomaten und Sub-Workflows
- Integrierte Agent-Presets für Programmierung, Recherche, Schreiben, Datenanalyse, Dokumente, Browser-Automatisierung und mehr
- Tool-Gruppen für Dateien, Shell, Git, HTTP, Browser, Dokumente, Datenbanken, RAG, E-Mail und mehr
- Delegiere an externe Coding-Agents über Claude Code- und OpenAI Codex-Subprozesse
- Native Subprozesse für die lokale Entwicklung, Docker-Subprozesse für die Produktionsisolierung
- Integriert Modelle von Anthropic, OpenAI, DeepSeek, OpenRouter, Z.ai und NVIDIA über Koog
- Kann als MCP-Server laufen und Tool-Gruppen für andere Clients bereitstellen
# Kommandozeilen-Tool bauen
./gradlew installDist
# Validiere und führe das im examples-Verzeichnis mitgelieferte Beispiel aus
./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: Binden Sie Braidrun in einer vertrauten Sprache an
Dreizehn typsichere Clients für 12 Sprachen übersetzen die offene Plattform-API in vertraute Methoden, Modelle und Fehlertypen für Ihren Technologie-Stack.
Rufen Sie die Braidrun-Cloud-Plattform über das SDK aus einer bestehenden Anwendung auf: Starten Sie Workflows, prüfen Sie Ausführungsergebnisse, lesen Sie Artefakte, bearbeiten Sie menschliche Freigaben und integrieren Sie Webhooks. Alle Clients werden aus derselben OpenAPI-Spezifikation generiert, sodass ihre Schnittstellen und Datenmodelle aufeinander abgestimmt bleiben.
- Workflows finden und Ausführungen asynchron starten
- Ausführungsstatus, Endergebnisse und Artefakte lesen und laufende Ausführungen abbrechen
- Menschliche Freigaben prüfen, genehmigen oder ablehnen sowie Webhooks verwalten und auslösen
- Typisierte APIs und Datenmodelle mit Unterstützung für Bearer, X-API-Key und Berechtigungsbereiche
- Jedes Sprachverzeichnis enthält Dokumentation zu Installation, Konfiguration, Endpunkten und Modellen
Als Kommandozeilen-Tool oder eingebettet in dein eigenes Projekt
Derselbe Parser und Executor: direkt im Terminal ausführen oder als Kotlin/JVM-Bibliothek einbinden.
Nach dem Build erhältst du einen braidrun-workflow-Befehl, der Workflows validiert, im Probelauf prüft und ausführt — und der auch einen einzelnen voreingestellten Agent ohne Workflow-Datei starten kann. Ideal für Skripting und Automatisierungs-Pipelines.
braidrun-workflow agent \
--preset researcher \
--prompt "Fasse dieses Repository zusammen und liste drei Anwendungsfälle auf"- run / validate / dry-run decken Ausführung und Prüfung ab
- list-presets und list-tools zeigen die integrierten Funktionen
- mcp-server stellt Tool-Gruppen als MCP-Server bereit
Veröffentlichte Versionen werden über JitPack verteilt. Eine einzige Abhängigkeitszeile genügt, um WorkflowParser und WorkflowExecutor in deiner eigenen JVM-Anwendung aufzurufen — exakt dieselbe Implementierung, die auch die CLI verwendet.
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser · WorkflowExecutor sofort einsatzbereit
- Native Subprozesse für die Entwicklung, Docker-Subprozesse für die Produktion
- Erfordert JDK 21 oder neuer; der Docker-Isolationsmodus benötigt Docker
Die Open-Source-Edition gibt dir die Engine, die Cloud-Plattform die komplette Werkbank
Beide Seiten teilen sich dieselbe Laufzeit. Zeile für Zeile zeigt sich hier, welche Funktionen die Open-Source-Edition mitbringt und welche die Cloud-Plattform darüber hinaus ergänzt.
| Fähigkeit | Open-Source-Editionbraidrun-workflow | Cloud-Plattformbraidrun.com |
|---|---|---|
| Workflow-Laufzeit-Engine (YAML) | ✓Selbst bereitstellen und ausführen | ✓Dieselbe Engine, für dich gehostet |
| CLI- und Bibliotheksintegration | ✓CLI plus Kotlin/JVM-Bibliothek | ✓Über die offiziellen SDKs oder die REST-API anbinden |
| Visueller Editor (Canvas ⇄ YAML) | —Keine Oberfläche — YAML bearbeiten | ✓Canvas und YAML synchron in beide Richtungen |
| Dialogorientierter KI-Assistent zum Erstellen von Workflows | —Nicht verfügbar | ✓Workflows per Chat erstellen und bearbeiten |
| Breakpoint-Debugging und erneute Läufe fehlgeschlagener Schritte | —Selbst debuggen | ✓Werte am Breakpoint ändern und fortsetzen; abgeschlossene Schritte werden nicht erneut berechnet |
| Auto-Resume nach Service-Neustart | —Selbst implementieren | ✓Automatische Wiederherstellung nach Prüfung des Definitions-Hashes |
| Laufverlauf und Überwachung | △Eigenes Logging aufbauen | ✓Ausführungsverlauf, Kostenabrechnung und Warnungen |
| Vorlagen und Module | △Einige Beispiele im Repository enthalten | ✓240+ Vorlagen, 120+ Module und ein Marktplatz |
| Menschliche Genehmigungs-Gates | △Zur Laufzeit unterstützt; Benachrichtigungen in Eigenregie | ✓In-App- / E-Mail- / API-Benachrichtigungen |
| Zeitplan- / Webhook- / API-Trigger | △Selbst planen | ✓Integrierte Trigger und verkettete Planung |
| Teamzusammenarbeit und Berechtigungen | —Nicht verfügbar | ✓Teams, Rollen und Freigabe |
| Sandboxing und Secret-Verwaltung | ✓Docker-Isolierung, selbst verwaltet | ✓Gehostete Sandbox plus Secret-Verschlüsselung |
| Technischer Support | —Nur Community, kein offizieller Support | ✓Professioneller technischer Support |
| Private Bereitstellung | ✓Per Definition selbst gehostet | ✓Private Bereitstellung im Enterprise-Plan |
Wenn du weniger Infrastruktur verwalten und mehr Workflows bauen willst
Die Open-Source-Edition übergibt dir die Engine zum Selbstbetrieb; die Cloud-Plattform ergänzt Oberfläche, Zusammenarbeit, Hosting und Support, damit Workflows schneller live gehen und leichter zu warten sind.
Wenn die Open-Source-Edition völlig ausreicht
Wir sind nicht der Meinung, dass jeder in die Cloud wechseln sollte. In den drei folgenden Fällen ist die Open-Source-Edition für sich genommen die richtige Wahl.
Informationen zu Engine, SDK und Cloud-Plattform
Sind die Open-Source-Edition und die Cloud-Plattform dieselbe Engine?
Ja. Die Cloud-Plattform baut auf derselben Open-Source-Laufzeit auf und ergänzt visuelle Bearbeitung, Zusammenarbeit, Laufverlauf, Überwachung und gehostete Ausführung. YAML, das du in der Open-Source-Edition zum Laufen bringst, lässt sich nahezu unverändert in die Cloud übernehmen.
Unter welcher Lizenz steht braidrun-workflow? Kann ich es kommerziell nutzen?
Sie steht unter der Apache-2.0-Lizenz, die kommerzielle Nutzung und Modifikation erlaubt, solange du die Lizenz- und Copyright-Hinweise beibehältst. Siehe die LICENSE-Datei im Repository.
Was ist der Unterschied zwischen dem SDK und der Open-Source-Workflow-Engine?
Mit dem SDK kann Ihre Anwendung die API der Braidrun-Cloud-Plattform aufrufen; es ist für die Integration mehrsprachiger Systeme konzipiert. braidrun-workflow kombiniert eine Workflow-Engine mit einem Befehlszeilentool und läuft lokal oder auf Ihren eigenen Servern.
Kann ich das SDK direkt über den Paketmanager der jeweiligen Sprache installieren?
Das SDK wird derzeit über sein GitHub-Quellcode-Repository bereitgestellt; die Verfügbarkeit in sprachspezifischen Paketmanagern kann variieren. Wählen Sie einen Client aus und folgen Sie den Installationshinweisen in der README-Datei des jeweiligen Verzeichnisses.
Bietet die Open-Source-Edition technischen Support?
Das Open-Source-Projekt bietet keinen offiziellen technischen Support und stützt sich auf Community und Dokumentation. Wenn du Reaktionen durch dediziertes Personal und eine Service-Level-Zusage benötigst, nutze die Cloud-Plattform oder den Enterprise-Plan.
Kann ich mit der Open-Source-Edition beginnen und später zur Cloud-Plattform migrieren?
Ja. Viele Teams validieren einen Workflow zunächst über die Kommandozeile und übertragen ihn dann für die visuelle Oberfläche, Zusammenarbeit und Hosting auf die Cloud-Plattform. Workflows werden in standardmäßigem YAML definiert, sodass die Migration kaum Aufwand verursacht.
Führt die Nutzung der Cloud-Plattform zu einem Lock-in?
Die Kern-Engine ist Open Source und Workflows werden in standardmäßigem YAML definiert. Du kannst einen Workflow jederzeit exportieren und selbst in der Open-Source-Edition ausführen — es gibt keinen Lock-in.