Repolode
Enviar
capsulerun

capsulerun/runtime

Runtime que executa código não confiável para agentes de IA em sandboxes WebAssembly isolados, com limites de CPU, memória e tempo por tarefa.

Ver no GitHub
Estrelas
303
Forks
22
Issues abertas
0
Último commit
há 26 dias

O que é?

Capsule é um runtime para executar código não confiável em ambientes isolados. Cada tarefa roda em seu próprio sandbox WebAssembly, separado do sistema host. Os desenvolvedores marcam funções em Python ou TypeScript/JavaScript com um wrapper de tarefa, e o runtime compila o arquivo para WebAssembly e o executa.

Cada tarefa pode receber um nível de processamento, um limite de RAM, um tempo limite e uma quantidade de tentativas. O uso de CPU é controlado por meio da medição de fuel do WebAssembly. O acesso a arquivos fica restrito a diretórios explicitamente permitidos, nos modos somente leitura ou leitura e gravação, e o acesso à rede de saída é limitado a uma lista de hosts permitidos. As variáveis de ambiente só são disponibilizadas quando estão listadas. Cada execução retorna um envelope JSON com o resultado, detalhes de erro e métricas de execução, como duração, fuel consumido e pico de memória.

O projeto oferece uma CLI (`capsule run`, `capsule build`) e SDKs para Python e npm, incluindo uma função `run()` para chamar tarefas em sandbox a partir do código host. Pacotes Python que dependem de extensões C precisam ter um build wasm32-wasi para rodar dentro do sandbox.

Recursos principais

  • 01Executa cada tarefa em seu próprio sandbox WebAssembly, isolado do host.
  • 02Limita o uso de CPU por meio da medição de fuel e permite configurar RAM e tempo limite por tarefa.
  • 03Restringe o acesso a arquivos aos diretórios listados, nos modos somente leitura ou leitura e gravação.
  • 04Permite tráfego HTTP de saída apenas para domínios autorizados.
  • 05Oferece suporte a tarefas em Python e TypeScript/JavaScript, com novas tentativas automáticas.
  • 06Retorna um resultado JSON estruturado com métricas de duração, fuel e memória.

Casos de uso

  • Executar código gerado por LLMs em um interpretador de código sem expor a máquina host.
  • Executar chamadas de ferramentas de agentes de IA com limites rigorosos para arquivos, hosts de rede e variáveis de ambiente.
  • Empacotar pequenas funções no estilo serverless que precisam de limites previsíveis de recursos.
  • Chamar código Python ou TypeScript em sandbox a partir de uma aplicação host usando `run()`.

Início rápido

  1. 1

    Instale o pacote Python

    pip install capsule-run
  2. 2

    Crie hello.py com uma tarefa main que retorne uma saudação

  3. 3

    Execute o arquivo com o Capsule CLI

    capsule run hello.py

Antes de usar

  • O README mostra apenas exemplos em Python e TypeScript, portanto outras linguagens não são abordadas.
  • A compilação dos arquivos-fonte adiciona alguns segundos de latência na primeira execução, a menos que você os pré-compile com capsule build.

Em coleções

Sandboxes para agentes de IAFrameworks e apps de agentes de IA open source

Tópicos

#ai-agents#sandbox#webassembly#code-execution#wasm#rust#python#typescript#agentic-workflow#code-interpreter

Perguntas frequentes

O que é runtime?
Runtime que executa código não confiável para agentes de IA em sandboxes WebAssembly isolados, com limites de CPU, memória e tempo por tarefa. Capsule é um runtime para executar código não confiável em ambientes isolados. Cada tarefa roda em seu próprio sandbox WebAssembly, separado do sistema host. Os desenvolvedores marcam funções em Python ou TypeScript/JavaScript com um wrapper de tarefa, e o runtime compila o arquivo para WebAssembly e o executa.
runtime é gratuito? Qual é a licença?
runtime é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
runtime ainda é mantido?
Manutenção ativa. O último commit de runtime foi em 12 de out. de 2026.
Para que posso usar runtime?
Executar código gerado por LLMs em um interpretador de código sem expor a máquina host. Executar chamadas de ferramentas de agentes de IA com limites rigorosos para arquivos, hosts de rede e variáveis de ambiente. Empacotar pequenas funções no estilo serverless que precisam de limites previsíveis de recursos. Chamar código Python ou TypeScript em sandbox a partir de uma aplicação host usando `run()`.
Como instalar runtime?
Instale o pacote Python: pip install capsule-run Crie hello.py com uma tarefa main que retorne uma saudação Execute o arquivo com o Capsule CLI: capsule run hello.py
Onde consigo runtime?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/capsulerun/runtime

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados