Acesso pela CLI.
Inicie uma execução e consulte seu status pelo terminal. Use os mesmos comandos nos seus scripts para automatizar Executions recorrentes.
EXECUTIONSExecute código na nuvem.
Execute código na nuvem.
Direto da sua aplicação.
Integre execução de código ao seu produto por SDK ou API. Processe arquivos e tarefas em máquinas virtuais isoladas, com recursos definidos para cada execução.
Uma máquina virtual
para cada Execution.
Cada Execution inicia uma máquina virtual para executar seu código. Gere PDFs, transforme dados ou processe arquivos enviados pela sua aplicação.
Quando a Execution termina, a máquina é encerrada. Os resultados e arquivos coletados ficam disponíveis para você consultar depois.
Como usar Executions.
Execute pelo terminal, use o painel ou integre à sua aplicação.
Acesso pelo painel.
Crie e acompanhe execuções pelo painel da runvibe_. Escolha o código e os recursos; depois, consulte o status, os logs e os arquivos gerados.
Integração da aplicação pelo SDK.
Inicie Executions pelo código da sua aplicação usando o SDK. Acompanhe a execução e use o resultado no próximo passo do processamento.
Execução dentro do seu produto.
Sua aplicação envia uma tarefa, acompanha a execução e usa o resultado no próximo passo. A runvibe_ verifica as permissões e a configuração antes de iniciar.
Uma aplicação de IA pode enviar um arquivo para processamento e recuperar os resultados coletados para continuar a tarefa.
Conecte suas ferramentas de IA.
Conecte uma ferramenta compatível com MCP, como Codex, Claude Code ou Cursor, para iniciar Executions e consultar os resultados.
'%3e%3c/path%3e%3cpath%20d='M20.616%2010.835a14.147%2014.147%200%2001-4.45-3.001%2014.111%2014.111%200%2001-3.678-6.452.503.503%200%2000-.975%200%2014.134%2014.134%200%2001-3.679%206.452%2014.155%2014.155%200%2001-4.45%203.001c-.65.28-1.318.505-2.002.678a.502.502%200%20000%20.975c.684.172%201.35.397%202.002.677a14.147%2014.147%200%20014.45%203.001%2014.112%2014.112%200%20013.679%206.453.502.502%200%2000.975%200c.172-.685.397-1.351.677-2.003a14.145%2014.145%200%20013.001-4.45%2014.113%2014.113%200%20016.453-3.678.503.503%200%20000-.975%2013.245%2013.245%200%2001-2.003-.678z'%20fill='url(%23lobe-icons-gemini-1-_R_0_)'%3e%3c/path%3e%3cpath%20d='M20.616%2010.835a14.147%2014.147%200%2001-4.45-3.001%2014.111%2014.111%200%2001-3.678-6.452.503.503%200%2000-.975%200%2014.134%2014.134%200%2001-3.679%206.452%2014.155%2014.155%200%2001-4.45%203.001c-.65.28-1.318.505-2.002.678a.502.502%200%20000%20.975c.684.172%201.35.397%202.002.677a14.147%2014.147%200%20014.45%203.001%2014.112%2014.112%200%20013.679%206.453.502.502%200%2000.975%200c.172-.685.397-1.351.677-2.003a14.145%2014.145%200%20013.001-4.45%2014.113%2014.113%200%20016.453-3.678.503.503%200%20000-.975%2013.245%2013.245%200%2001-2.003-.678z'%20fill='url(%23lobe-icons-gemini-2-_R_0_)'%3e%3c/path%3e%3cdefs%3e%3clinearGradient%20gradientUnits='userSpaceOnUse'%20id='lobe-icons-gemini-0-_R_0_'%20x1='7'%20x2='11'%20y1='15.5'%20y2='12'%3e%3cstop%20stop-color='%2308B962'%3e%3c/stop%3e%3cstop%20offset='1'%20stop-color='%2308B962'%20stop-opacity='0'%3e%3c/stop%3e%3c/linearGradient%3e%3clinearGradient%20gradientUnits='userSpaceOnUse'%20id='lobe-icons-gemini-1-_R_0_'%20x1='8'%20x2='11.5'%20y1='5.5'%20y2='11'%3e%3cstop%20stop-color='%23F94543'%3e%3c/stop%3e%3cstop%20offset='1'%20stop-color='%23F94543'%20stop-opacity='0'%3e%3c/stop%3e%3c/linearGradient%3e%3clinearGradient%20gradientUnits='userSpaceOnUse'%20id='lobe-icons-gemini-2-_R_0_'%20x1='3.5'%20x2='17.5'%20y1='13.5'%20y2='12'%3e%3cstop%20stop-color='%23FABC12'%3e%3c/stop%3e%3cstop%20offset='.46'%20stop-color='%23FABC12'%20stop-opacity='0'%3e%3c/stop%3e%3c/linearGradient%3e%3c/defs%3e%3c/svg%3e){kind=small}
Configure execuções
reutilizáveis.
Manifestos em TOML.
Descreva o que executar e os recursos necessários em um arquivo TOML. Inclua variáveis, volumes, regras de rede e limite de tempo. Reutilize esse manifesto para iniciar novas execuções com a mesma configuração.
Packages no manifesto.
Informe qual Package usar, o arquivo de entrada e seus argumentos. A Execution inicia esse arquivo; chamadas a funções específicas ficam no próprio código.
Nos usos sujeitos à revisão, o conteúdo exato do Package precisa estar aprovado. A aprovação não substitui as permissões e as políticas da execução.
Conheça o fluxo de aprovação ↗Volumes com dados de entrada.
Disponibilize os arquivos de um volume no caminho esperado pelo script ou container. A Execution preserva o volume de origem; em containers, as cópias graváveis são temporárias.
Variáveis de ambiente.
Declare no manifesto os valores de configuração que o processo precisa. Para Executions com containers, defina as variáveis de cada container.
Credenciais com Secrets.
Guarde tokens, senhas e chaves de API no cofre de Secrets. Na configuração da Execution, associe uma referência ao Secret à variável de ambiente que a aplicação espera. O processo recebe o valor ao executar, sem que você precise escrevê-lo no código ou no manifesto.
Controle de rede.
Sem acesso externo.
Desative a rede de saída para Executions que processam apenas os dados fornecidos.
Destinos autorizados.
Restrinja a saída por IP, faixa ou domínio, com protocolos e portas definidos.
Política aplicada pelo host.
As regras são aplicadas pelo host, que bloqueia acesso a redes privadas, endereços locais e metadados da infraestrutura, inclusive no modo público.
Download e execução separados.
Para containers, configure uma política para baixar as imagens e outra para o código em execução. Permitir um registry no download não libera esse acesso durante a Execution.
Escolha o formato
da sua execução.
Envie um script, um Package ou uma configuração de containers. Scripts e Packages podem usar uma imagem preparada nos runtimes compatíveis.
Scripts Python e Node.js.
Envie seu código Python ou JavaScript diretamente e escolha o runtime. O script inicia no diretório de trabalho com as variáveis e os volumes que você configurou.
Use esse formato para automações pontuais, transformação de dados ou código gerado pela IA. O envio direto dispensa empacotar o projeto em um ZIP.
Imagens com o ambiente preparado.
Use uma imagem com ferramentas e dependências já instaladas, que você pode preparar em um Workspace. Scripts e Packages usam esse ambiente nos runtimes compatíveis.
Cada execução recebe uma cópia gravável da imagem. Instalações e alterações ficam nessa cópia, preservando a imagem publicada para as próximas Executions.
Containers a partir de imagens OCI.
Informe uma imagem OCI, o comando e as variáveis de ambiente. Adicione serviços auxiliares quando sua Execution precisar deles. Os containers da mesma Execution compartilham CPU, memória e rede.
Use esse formato para aplicações já empacotadas em containers. Os códigos de saída e logs de cada container ficam disponíveis após a coleta.
Packages reutilizáveis.
Reúna o código e os arquivos do projeto em um ZIP para enviá-los juntos. Use Packages quando o processamento depender de vários arquivos, como módulos Python e modelos de relatório.
Reutilize o Package em novas Executions sem reenviar os arquivos.
Consulte resultados
e baixe arquivos.
Após a coleta, use o ID da Execution para consultar resultados e arquivos pela API, CLI ou MCP. Grave o resultado estruturado em result.json e os arquivos em outputs/.
Resultado estruturado pela API.
Grave os dados em result.json. Consulte o resultado JSON pela API e use os dados na sua aplicação.
Arquivos gerados pela Execution.
Salve relatórios, documentos e outros arquivos em outputs/. Consulte os artefatos pela API e solicite o download do arquivo desejado. A disponibilidade segue os limites e a retenção da plataforma.
Acesso pela CLI ou pela IA.
Pela CLI, consulte o resultado e baixe os artefatos usando o ID da Execution. Com sua ferramenta de IA conectada via MCP, peça para recuperar o resultado ou os arquivos gerados e continuar o trabalho com eles.
Logs e métricas da execução.
Consulte a saída padrão e os erros em stdout e stderr. Acompanhe status, duração e métricas de recursos. Em containers, os logs ficam disponíveis após a coleta ao final.
Isolamento e controle
por execução.
Kernel próprio
A Execution roda em uma máquina virtual com kernel separado do host e das outras execuções. Containers de uma mesma Execution compartilham o kernel dessa máquina.
Forward para acesso local
Encaminhe portas pela CLI em Executions ativas de containers ou Packages configuradas sem limite de duração. Scripts diretos não oferecem esse acesso. O encaminhamento termina junto com a Execution.
Recursos definidos
Defina CPU e memória para cada execução de acordo com o processamento necessário.
Tempo e cancelamento
Defina um limite de tempo para a Execution e solicite o cancelamento quando precisar interromper a execução.
Pague pelo tempo
em execução.
Na nuvem runvibe_, o processamento consome o saldo do plano conforme os recursos e o tempo em execução.
A cobrança da execução termina com a tarefa; a mensalidade e o armazenamento seguem as regras do plano.
Simular meu uso ↗Inicie a Execution
Código, entradas e configuração definidos
Execute na nuvem
Consumo conforme os recursos e o tempo de uso
Consulte os resultados
Execution encerrada · ambiente de execução liberado
Perguntas frequentes.
Preciso criar um Workspace antes?
Não. Você pode iniciar uma Execution com código Python ou Node.js, um Package ou containers. Use um Workspace quando quiser preparar e testar uma imagem de ambiente para reutilizar depois.
Como o Package e o manifesto trabalham juntos?
O Package contém o código e os arquivos; o manifesto define como executá-los e quais recursos usar. Ver configuração ↗
Como recebo o resultado na minha aplicação?
Grave os dados em result.json e os arquivos em outputs/. Consulte-os após a coleta pelo ID da Execution. Ver resultados e arquivos ↗
Posso usar uma imagem preparada no Workspace?
Sim, nos runtimes compatíveis com imagens preparadas. Essa imagem permite reutilizar um ambiente com dependências instaladas. A execução de containers usa imagens OCI e tem uma configuração própria.
Onde consulto erros e consumo de recursos?
No detalhe da execução, consulte o status, stdout, stderr e as métricas registradas. Em execuções de containers, os logs são coletados ao final da Execution.
Quando escolher Execution ou Workspace?
Use Execution para processamentos com início e fim definidos, integrados à sua aplicação ou automação. Escolha Workspace para desenvolver, testar sua aplicação e retomar o trabalho no mesmo ambiente.