O motor de fluxos de trabalho e o SDK da Braidrun são agora de código aberto
Execute o motor de fluxos de trabalho Apache-2.0 no seu próprio ambiente e ligue aplicações existentes à plataforma cloud da Braidrun através de 13 clientes SDK oficiais. Ambos os caminhos são de código aberto no GitHub e dão acesso às mesmas capacidades de fluxo de trabalho.
trançarun-workflow: o tempo de execução do fluxo de trabalho aberto
Um mecanismo que executa fluxos de trabalho de IA definidos em YAML, na linha de comando ou no código Kotlin — o mesmo tempo de execução que a plataforma de nuvem executa nos bastidores.
O repositório de código aberto contém o tempo de execução do fluxo de trabalho completo e a ferramenta de linha de comando. Ele executa as etapas definidas em seu YAML em ordem – agentes, código, chamadas de ferramentas e subfluxos de trabalho – e os isola com subprocessos do Docker em produção.
- Fluxos de trabalho definidos em YAML, executáveis a partir da CLI ou código Kotlin
- Etapas de agente, etapas de código, paralelismo, condições, iteração, novas tentativas, máquinas de estado e subfluxos de trabalho
- Predefinições de agente integradas para codificação, pesquisa, redação, análise de dados, documentos, automação de navegador e muito mais
- Grupos de ferramentas para arquivos, shell, Git, HTTP, navegador, documentos, bancos de dados, RAG, email e muito mais
- Delegar para agentes de codificação externos por meio de subprocessos Claude Code e OpenAI Codex
- Subprocessos nativos para desenvolvimento local, subprocessos Docker para isolamento de produção
- Integra modelos Anthropic, OpenAI, DeepSeek, OpenRouter, Z.ai e NVIDIA via Koog
- Pode ser executado como um servidor MCP, expondo grupos de ferramentas a outros clientes
# Crie a ferramenta de linha de comando
./gradlew installDist
# Valide e execute o exemplo incluído no diretório de exemplos
./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: ligue-se à Braidrun numa linguagem que conhece
Treze clientes com tipagem segura, em 12 linguagens, transformam a API da plataforma aberta em métodos, modelos e tipos de erro familiares para a sua stack tecnológica.
Use o SDK numa aplicação existente para aceder à plataforma cloud da Braidrun: inicie fluxos de trabalho, consulte resultados de execução, leia artefactos, processe aprovações humanas e integre webhooks. Todos os clientes são gerados a partir da mesma especificação OpenAPI, mantendo alinhadas as respetivas interfaces e modelos de dados.
- Encontrar fluxos de trabalho e iniciar execuções de forma assíncrona
- Consultar o estado da execução, os resultados finais e os artefactos, e cancelar execuções ativas
- Rever, aprovar ou rejeitar pedidos de aprovação humana e gerir e acionar webhooks
- APIs e modelos de dados tipados, com suporte para Bearer, X-API-Key e âmbitos de permissão
- O diretório de cada linguagem inclui documentação de instalação, configuração, endpoints e modelos
Como uma ferramenta de linha de comando ou incorporada ao seu próprio projeto
O mesmo analisador e executor: execute-o diretamente no terminal ou dependa dele como uma biblioteca Kotlin/JVM.
Após a construção, você obtém um comando trançarun-workflow que valida, simula e executa fluxos de trabalho – e pode executar um único agente predefinido sem um arquivo de fluxo de trabalho. Ideal para pipelines de script e automação.
braidrun-workflow agent \
--preset researcher \
--prompt "Resuma este repositório e liste três casos de uso"- execução/validação/execução de cobertura de teste e verificação
- list-presets e list-tools mostram os recursos integrados
- mcp-server expõe grupos de ferramentas como um servidor MCP
As versões lançadas são distribuídas através do JitPack. Uma linha de dependência permite chamar WorkflowParser e WorkflowExecutor em seu próprio aplicativo JVM — exatamente a mesma implementação que a CLI usa.
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.Braidrun:braidrun-workflow:1.0.5")
}- WorkflowParser e WorkflowExecutor estão prontos para uso
- Subprocessos nativos para desenvolvimento, subprocessos Docker para produção
- Requer JDK 21 ou mais recente; O modo de isolamento do Docker precisa do Docker
A edição de código aberto fornece o mecanismo; a plataforma em nuvem oferece todo o ambiente de trabalho
Ambos os lados compartilham o mesmo tempo de execução. Linha por linha, aqui está o que a edição de código aberto inclui e o que a plataforma em nuvem adiciona.
| Capacidade | Edição de código abertobraidrun-workflow | Plataforma em nuvembraidrun.com |
|---|---|---|
| Mecanismo de tempo de execução de fluxo de trabalho (YAML) | ✓Implante e execute você mesmo | ✓Mesmo mecanismo, hospedado para você |
| Integração CLI e biblioteca | ✓CLI mais biblioteca Kotlin/JVM | ✓Ligue-se através dos SDKs oficiais ou da API REST |
| Editor visual (canvas ⇄ YAML) | —Sem IU – edite YAML | ✓Canvas e YAML permanecem sincronizados nos dois sentidos |
| Assistente de IA conversacional para criação de fluxos de trabalho | —Não fornecido | ✓Gere e edite fluxos de trabalho conversando |
| Depuração de ponto de interrupção e reexecuções de etapas com falha | —Depure você mesmo | ✓Altere os valores em um ponto de interrupção e retome; as etapas concluídas não serão cobradas novamente |
| Retomada automática após reinício do serviço | —Implemente você mesmo | ✓Recupera automaticamente após verificar o hash de definição |
| Histórico de execução e monitoramento | △Crie seu próprio registro | ✓Histórico de execução, contabilidade de custos e alertas |
| Modelos e módulos | △Alguns exemplos incluídos no repositório | ✓Mais de 240 modelos, mais de 120 módulos e um mercado |
| Portões de aprovação humana | △Suportado em tempo de execução; as notificações são suas | ✓Notificações no aplicativo/e-mail/API |
| Agendamento/webhook/gatilhos de API | △Agende você mesmo | ✓Gatilhos integrados e agendamento encadeado |
| Colaboração e permissões em equipe | —Não fornecido | ✓Equipes, funções e compartilhamento |
| Sandboxing e gerenciamento de segredos | ✓Isolamento do Docker, gerenciado por você | ✓Sandbox hospedado mais criptografia secreta |
| Suporte técnico | —Somente comunidade, sem suporte oficial | ✓Suporte técnico profissional |
| Implantação privada / self-hosted | ✓Auto-hospedado por definição | ✓Implantação privada no plano Enterprise |
Se você preferir gerenciar menos infraestrutura e criar mais fluxos de trabalho
A edição de código aberto oferece a você o mecanismo para funcionar sozinho; a plataforma em nuvem adiciona interface, colaboração, hospedagem e suporte, para que os fluxos de trabalho sejam entregues mais rapidamente e sejam mais fáceis de manter.
Quando a edição de código aberto é tudo que você precisa
Não achamos que todos devam migrar para a nuvem. Nos três casos abaixo, a edição de código aberto é a escolha certa por si só.
Sobre o motor, o SDK e a plataforma cloud
A edição de código aberto e a plataforma em nuvem são o mesmo mecanismo?
Sim. A plataforma em nuvem é construída no mesmo tempo de execução de código aberto, adicionando edição visual, colaboração, histórico de execução, monitoramento e execução hospedada. O YAML que você trabalha na edição de código aberto pode migrar para a nuvem quase inalterado.
Que licença utiliza o braidrun-workflow? Posso utilizá-lo comercialmente?
Está sob a licença Apache-2.0, que permite uso comercial e modificação, desde que você mantenha a licença e os avisos de direitos autorais. Veja o arquivo LICENSE no repositório.
Qual é a diferença entre o SDK e o motor de fluxos de trabalho de código aberto?
O SDK permite que a sua aplicação chame a API da plataforma cloud da Braidrun e destina-se à integração de sistemas em várias linguagens. O braidrun-workflow é um motor de fluxos de trabalho e uma ferramenta de linha de comandos que é executada localmente ou nos seus próprios servidores.
Posso instalar o SDK diretamente a partir do gestor de pacotes de cada linguagem?
Atualmente, o SDK é distribuído através do respetivo repositório de código-fonte no GitHub, e a disponibilidade nos gestores de pacotes específicos de cada linguagem pode variar. Escolha um cliente e siga as instruções de instalação no README desse diretório.
A edição de código aberto vem com suporte técnico?
O projeto de código aberto não oferece suporte técnico oficial e depende da comunidade e da documentação. Se você precisar de respostas com equipe e de um compromisso de nível de serviço, use a plataforma em nuvem ou o plano Enterprise.
Posso começar com a edição de código aberto e migrar para a plataforma em nuvem posteriormente?
Sim. Muitas equipes primeiro validam um fluxo de trabalho na linha de comando e depois o movem para a plataforma em nuvem para obter interface visual, colaboração e hospedagem. Os fluxos de trabalho são definidos em YAML padrão, portanto a migração custa pouco.
Usar a plataforma em nuvem me prende?
O mecanismo principal é de código aberto e os fluxos de trabalho são definidos em YAML padrão. Você pode exportar um fluxo de trabalho e executá-lo você mesmo na edição de código aberto a qualquer momento — não há aprisionamento.