El motor de flujos de trabajo y los SDK de Braidrun ya son de código abierto
Ejecuta el motor de flujos de trabajo Apache-2.0 en tu propio entorno y conecta aplicaciones existentes a la plataforma en la nube de Braidrun con 13 clientes SDK oficiales. Ambas opciones tienen el código publicado en GitHub y ofrecen las mismas funciones de flujos de trabajo.
braidrun-workflow: el runtime abierto de flujos de trabajo
Un motor que ejecuta flujos de trabajo de IA definidos en YAML, desde la línea de comandos o desde código Kotlin: el mismo runtime que hay detrás de la plataforma en la nube.
El repositorio de código abierto contiene el runtime de flujos de trabajo y la herramienta de línea de comandos completos. Ejecuta en orden los pasos definidos en tu YAML —agentes, código, llamadas a herramientas y subflujos de trabajo— y los aísla con subprocesos de Docker en producción.
- Flujos de trabajo definidos en YAML, ejecutables desde la CLI o desde código Kotlin
- Pasos de agente, pasos de código, paralelismo, condiciones, iteración, reintentos, máquinas de estados y subflujos de trabajo
- Preajustes de agente integrados para programación, investigación, redacción, análisis de datos, documentos, automatización de navegador y más
- Grupos de herramientas para archivos, Shell, Git, HTTP, navegador, documentos, bases de datos, RAG, correo electrónico y más
- Delega en agentes de programación externos a través de subprocesos de Claude Code y OpenAI Codex
- Subprocesos nativos para el desarrollo local, subprocesos de Docker para el aislamiento en producción
- Integra modelos de Anthropic, OpenAI, DeepSeek, OpenRouter, Z.ai y NVIDIA a través de Koog
- Puede ejecutarse como servidor MCP y exponer grupos de herramientas a otros clientes
# Compilar la herramienta de línea de comandos
./gradlew installDist
# Validar y ejecutar el ejemplo incluido en el directorio 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: conecta con Braidrun desde tu lenguaje habitual
Trece clientes con seguridad de tipos para 12 lenguajes convierten la API de la plataforma abierta en métodos, modelos y tipos de error familiares para tu stack tecnológico.
Usa los SDK desde una aplicación existente para llamar a la plataforma en la nube de Braidrun: inicia flujos de trabajo, consulta resultados de ejecución, lee artefactos, gestiona aprobaciones humanas e integra webhooks. Todos los clientes se generan a partir de la misma especificación OpenAPI, por lo que sus interfaces y modelos de datos se mantienen alineados.
- Consultar flujos de trabajo e iniciar ejecuciones de forma asíncrona
- Leer el estado, los resultados finales y los artefactos, y cancelar ejecuciones activas
- Consultar, aprobar o rechazar aprobaciones humanas, y administrar y activar webhooks
- API y modelos de datos tipados compatibles con Bearer, X-API-Key y ámbitos de permisos
- Cada directorio de lenguaje incluye documentación de instalación, configuración, endpoints y modelos
Como herramienta de línea de comandos o integrado en tu propio proyecto
El mismo analizador y ejecutor: ejecútalo directamente en la terminal o depende de él como biblioteca Kotlin/JVM.
Tras compilarlo, obtienes un comando braidrun-workflow que valida, hace dry-run y ejecuta flujos de trabajo, y que también puede ejecutar un único agente predefinido sin un archivo de flujo de trabajo. Ideal para scripting y canalizaciones de automatización.
braidrun-workflow agent \
--preset researcher \
--prompt "Resumir este repositorio y enumerar tres casos de uso"- run / validate / dry-run cubren la ejecución y la validación
- list-presets y list-tools muestran las capacidades integradas
- mcp-server expone grupos de herramientas como un servidor MCP
Las versiones publicadas se distribuyen a través de JitPack. Una sola línea de dependencia te permite invocar WorkflowParser y WorkflowExecutor en tu propia aplicación JVM, con exactamente la misma implementación que usa la CLI.
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser · WorkflowExecutor, listos para usar
- Subprocesos nativos para el desarrollo, subprocesos de Docker para producción
- Requiere JDK 21 o superior; el modo de aislamiento con Docker necesita Docker
La edición de código abierto te da el motor; la plataforma en la nube te da todo el banco de trabajo
Ambas partes comparten el mismo runtime. Fila por fila, esto es lo que incluye la edición de código abierto y lo que la plataforma en la nube añade encima.
| Capacidad | Edición de código abiertobraidrun-workflow | Plataforma en la nubebraidrun.com |
|---|---|---|
| Motor de ejecución de flujos de trabajo (YAML) | ✓Despliégalo y ejecútalo tú mismo | ✓El mismo motor, alojado para ti |
| CLI e integración como biblioteca | ✓CLI más biblioteca Kotlin/JVM | ✓Conecta mediante los SDK oficiales o la API REST |
| Editor visual (lienzo ⇄ YAML) | —Sin interfaz: edita YAML | ✓El lienzo y YAML se sincronizan en ambos sentidos |
| Asistente de IA conversacional para crear flujos de trabajo | —No disponible | ✓Genera y edita flujos de trabajo conversando |
| Depuración con puntos de interrupción y reejecución de pasos fallidos | —Depúralo tú mismo | ✓Cambia valores en un punto de interrupción y reanuda; los pasos completados no se vuelven a facturar |
| Reanudación automática tras reinicio del servicio | —Impleméntalo tú mismo | ✓Recuperación automática tras verificar el hash de la definición |
| Historial de ejecuciones y monitoreo | △Crea tu propio sistema de registro | ✓Historial de ejecución, contabilidad de costos y alertas |
| Plantillas y módulos | △Algunos ejemplos incluidos en el repositorio | ✓240+ plantillas, 120+ módulos y un marketplace |
| Puertas de aprobación humana | △Compatible en tiempo de ejecución; las notificaciones corren por tu cuenta | ✓Notificaciones en la aplicación / correo / API |
| Disparadores por programación / Webhook / API | △Prográmalo tú mismo | ✓Disparadores integrados y programación encadenada |
| Colaboración en equipo y permisos | —No disponible | ✓Equipos, roles y uso compartido |
| Sandbox y gestión de secretos | ✓Aislamiento con Docker, gestionado por ti | ✓Sandbox alojado más cifrado de secretos |
| Soporte técnico | —Solo comunidad, sin soporte oficial | ✓Soporte técnico profesional |
| Despliegue privado | ✓Autoalojado por definición | ✓Despliegue privado en el plan Enterprise |
Si prefieres gestionar menos infraestructura y crear más flujos de trabajo
La edición de código abierto te entrega el motor para que lo ejecutes tú mismo; la plataforma en la nube añade la interfaz, la colaboración, el alojamiento y el soporte, para que los flujos de trabajo se lancen más rápido y sean más fáciles de mantener.
Cuando la edición de código abierto es todo lo que necesitas
No creemos que todo el mundo deba pasarse a la nube. En los tres casos siguientes, la edición de código abierto es la opción adecuada por sí sola.
Acerca del motor, los SDK y la plataforma en la nube
¿La edición de código abierto y la plataforma en la nube usan el mismo motor?
Sí. La plataforma en la nube se construye sobre el mismo runtime de código abierto y añade edición visual, colaboración, historial de ejecuciones, monitoreo y ejecución gestionada. El YAML que consigues hacer funcionar en la edición de código abierto puede pasar a la nube casi sin cambios.
¿Qué licencia utiliza braidrun-workflow? ¿Se puede usar con fines comerciales?
Se distribuye bajo la licencia Apache-2.0, que permite el uso comercial y la modificación siempre que conserves los avisos de licencia y de copyright. Consulta el archivo LICENSE en el repositorio.
¿Qué diferencia hay entre los SDK y el motor de flujos de trabajo de código abierto?
Los SDK permiten que tu aplicación llame a la API de la plataforma en la nube de Braidrun y están pensados para integrar sistemas en distintos lenguajes. braidrun-workflow es un motor de flujos de trabajo y una herramienta de línea de comandos que puedes ejecutar localmente o en tus propios servidores.
¿Puedo instalar los SDK directamente desde el gestor de paquetes de cada lenguaje?
Actualmente, los SDK se distribuyen desde su repositorio de código en GitHub y su disponibilidad en los gestores de paquetes de cada lenguaje puede variar. Elige un cliente y sigue las instrucciones de instalación del README de su directorio.
¿La edición de código abierto incluye soporte técnico?
El proyecto de código abierto no ofrece soporte técnico oficial y se apoya en la comunidad y la documentación. Si necesitas respuestas de personal dedicado y un compromiso de nivel de servicio, usa la plataforma en la nube o el plan Enterprise.
¿Puedo empezar con la edición de código abierto y migrar a la plataforma en la nube más adelante?
Sí. Muchos equipos primero validan un flujo de trabajo desde la línea de comandos y luego lo trasladan a la plataforma en la nube para obtener la interfaz visual, la colaboración y el alojamiento. Los flujos de trabajo se definen en YAML estándar, así que migrar cuesta poco.
¿Usar la plataforma en la nube me genera dependencia de un proveedor?
El motor central es de código abierto y los flujos de trabajo se definen en YAML estándar. Puedes exportar un flujo de trabajo y ejecutarlo tú mismo en la edición de código abierto en cualquier momento: no hay dependencia de un proveedor.