Le moteur de workflows et les SDK de Braidrun sont désormais open source
Exécutez le moteur de workflows Apache-2.0 dans votre propre environnement et connectez vos applications existantes à la plateforme cloud Braidrun grâce à 13 clients SDK officiels. Le code source des deux approches est public sur GitHub et elles donnent accès aux mêmes fonctionnalités de workflow.
braidrun-workflow : le runtime de workflow ouvert
Un moteur qui exécute des workflows d'IA définis en YAML, en ligne de commande ou depuis du code Kotlin — le même runtime que celui qui tourne en coulisses sur la plateforme cloud.
Le dépôt open source contient le runtime de workflow complet et l'outil en ligne de commande. Il exécute dans l'ordre les étapes définies dans votre YAML — agents, code, appels d'outils et sous-workflows — et les isole avec des sous-processus Docker en production.
- Workflows définis en YAML, exécutables en CLI ou depuis du code Kotlin
- Étapes Agent, étapes de code, parallélisme, conditions, itérations, relances, machines à états et sous-workflows
- Préréglages d'Agent intégrés pour le codage, la recherche, la rédaction, l'analyse de données, les documents, l'automatisation du navigateur, etc.
- Groupes d'outils pour les fichiers, Shell, Git, HTTP, le navigateur, les documents, les bases de données, RAG, l'e-mail, etc.
- Déléguer à des Agents de codage externes via des sous-processus Claude Code et OpenAI Codex
- Sous-processus natifs pour le développement local, sous-processus Docker pour l'isolation en production
- Intègre les modèles Anthropic, OpenAI, DeepSeek, OpenRouter, Z.ai, NVIDIA, etc. via Koog
- Peut fonctionner comme serveur MCP, exposant des groupes d'outils à d'autres clients
# Compiler l'outil en ligne de commande
./gradlew installDist
# Valider et exécuter l'exemple fourni dans le répertoire 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 : connectez-vous à Braidrun dans votre langage habituel
Treize clients fortement typés couvrant 12 langages transforment l'API de la plateforme ouverte en méthodes, modèles et types d'erreurs familiers pour votre environnement technique.
Utilisez les SDK depuis une application existante pour appeler la plateforme cloud Braidrun : lancez des workflows, consultez les résultats d'exécution, lisez les artefacts, traitez les approbations humaines et intégrez des webhooks. Tous les clients sont générés à partir de la même spécification OpenAPI, ce qui garantit la cohérence des interfaces et des modèles de données.
- Rechercher des workflows et lancer des exécutions de manière asynchrone
- Lire l'état, les résultats finaux et les artefacts, et annuler les exécutions en cours
- Consulter, approuver ou refuser les approbations humaines, et gérer et déclencher des webhooks
- API et modèles de données typés prenant en charge Bearer, X-API-Key et les scopes d'autorisation
- Chaque répertoire de langage contient la documentation d'installation, de configuration, des endpoints et des modèles
Comme outil en ligne de commande, ou intégré dans votre propre projet
Le même parseur et le même exécuteur : à lancer directement dans le terminal, ou à utiliser comme dépendance sous forme de bibliothèque Kotlin/JVM.
Après compilation, vous obtenez une commande braidrun-workflow qui permet de valider, tester (dry-run) et exécuter des workflows — et même de lancer un seul Agent prédéfini sans fichier de workflow. Idéal pour le scripting et les pipelines d'automatisation.
braidrun-workflow agent \
--preset researcher \
--prompt "Résumer ce dépôt et lister trois cas d'usage"- run / validate / dry-run couvrent l'exécution et la validation
- list-presets et list-tools affichent les capacités intégrées
- mcp-server expose des groupes d'outils en tant que serveur MCP
Les versions publiées sont distribuées via JitPack. Une seule ligne de dépendance vous permet d'appeler WorkflowParser et WorkflowExecutor dans votre propre application JVM — exactement la même implémentation que celle utilisée par la CLI.
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser · WorkflowExecutor prêts à l'emploi
- Sous-processus natifs pour le développement, sous-processus Docker pour la production
- Nécessite JDK 21 ou une version ultérieure ; le mode d'isolation Docker requiert Docker
L'édition open source vous donne le moteur ; la plateforme cloud vous donne tout l'atelier
Les deux partagent le même runtime. Ligne par ligne, voici ce que l'édition open source inclut et ce que la plateforme cloud ajoute par-dessus.
| Capacité | Édition open sourcebraidrun-workflow | Plateforme cloudbraidrun.com |
|---|---|---|
| Moteur d'exécution de workflow (YAML) | ✓À déployer et exécuter vous-même | ✓Le même moteur, hébergé pour vous |
| CLI et intégration comme bibliothèque | ✓CLI plus bibliothèque Kotlin/JVM | ✓Connexion via les SDK officiels ou l'API REST |
| Éditeur visuel (canevas ⇄ YAML) | —Pas d'interface — éditer le YAML | ✓Le canevas et le YAML se synchronisent dans les deux sens |
| Assistant IA conversationnel pour créer des workflows | —Non fourni | ✓Générer et modifier des workflows par la conversation |
| Débogage par points d'arrêt et relance des étapes en échec | —À déboguer vous-même | ✓Modifiez les valeurs à un point d'arrêt et reprenez ; les étapes déjà terminées ne sont pas refacturées |
| Reprise automatique après redémarrage du service | —À implémenter vous-même | ✓Récupération automatique après vérification du hachage de la définition |
| Historique d'exécution et supervision | △Journalisation à mettre en place vous-même | ✓Historique d'exécution, calcul des coûts et alertes |
| Modèles et modules | △Quelques exemples fournis dans le dépôt | ✓240+ modèles, 120+ modules et une marketplace |
| Portes d'approbation humaine | △Pris en charge par le runtime ; notifications à mettre en place vous-même | ✓Notifications in-app / e-mail / API |
| Déclencheurs planifiés / Webhook / API | △À planifier vous-même | ✓Déclencheurs intégrés et planification en chaîne |
| Collaboration d'équipe et permissions | —Non fourni | ✓Équipes, rôles et partage |
| Sandbox et gestion des secrets | ✓Isolation Docker, gérée par vous | ✓Sandbox hébergée et chiffrement des secrets |
| Support technique | —Communauté uniquement, pas de support officiel | ✓Support technique professionnel |
| Déploiement privé | ✓Auto-hébergé par nature | ✓Déploiement privé avec l'offre Enterprise |
Si vous préférez gérer moins d'infrastructure et créer plus de workflows
L'édition open source vous confie le moteur à exécuter vous-même ; la plateforme cloud y ajoute l'interface, la collaboration, l'hébergement et le support, pour des workflows plus rapides à déployer et plus faciles à maintenir.
Ces cas où l'édition open source suffit
Nous ne pensons pas que tout le monde doive passer au cloud. Dans les trois cas ci-dessous, l'édition open source est le bon choix à elle seule.
À propos du moteur, des SDK et de la plateforme cloud
L'édition open source et la plateforme cloud utilisent-elles le même moteur ?
Oui. La plateforme cloud est bâtie sur le même runtime open source, en y ajoutant l'édition visuelle, la collaboration, l'historique d'exécution, la supervision et l'exécution hébergée. Le YAML que vous faites fonctionner dans l'édition open source peut être transféré vers le cloud presque sans modification.
Quelle licence utilise braidrun-workflow ? Peut-il être utilisé à des fins commerciales ?
Elle est sous licence Apache-2.0, qui autorise l'usage commercial et les modifications tant que vous conservez la licence et les mentions de copyright. Voir le fichier LICENSE dans le dépôt.
Quelle est la différence entre les SDK et le moteur de workflows open source ?
Les SDK permettent à votre application d'appeler l'API de la plateforme cloud Braidrun et sont adaptés à l'intégration de systèmes multilingues. braidrun-workflow est un moteur de workflows et un outil en ligne de commande qui s'exécute localement ou sur vos propres serveurs.
Puis-je installer les SDK directement depuis le gestionnaire de paquets de chaque langage ?
Les SDK sont actuellement distribués via leur dépôt source GitHub, et leur disponibilité dans les gestionnaires de paquets propres à chaque langage peut varier. Choisissez un client et suivez les instructions d'installation du README dans son répertoire.
L'édition open source est-elle fournie avec un support technique ?
Le projet open source ne fournit pas de support technique officiel et repose sur la communauté et la documentation. Si vous avez besoin de réponses assurées par une équipe dédiée et d'un engagement de niveau de service, utilisez la plateforme cloud ou l'offre Enterprise.
Puis-je commencer avec l'édition open source, puis migrer vers la plateforme cloud plus tard ?
Oui. De nombreuses équipes valident d'abord un workflow en ligne de commande, puis le transfèrent vers la plateforme cloud pour bénéficier de l'interface visuelle, de la collaboration et de l'hébergement. Les workflows sont définis en YAML standard, ce qui rend la migration peu coûteuse.
L'utilisation de la plateforme cloud entraîne-t-elle un enfermement ?
Le moteur principal est open source et les workflows sont définis en YAML standard. Vous pouvez à tout moment exporter un workflow et l'exécuter vous-même dans l'édition open source — il n'y a aucun enfermement.