Biblioteca Python que executa código gerado por LLMs em sandboxes isolados, com uma única API para backends Docker, Kubernetes, Podman e Linux ou Windows local.
1,1 mil+5 esta semana106PythonMITAtualizado ontem
tjmlabs/AgentRun
Uma biblioteca Python e uma API REST que executam código Python gerado por LLM em um container Docker isolado, com limites de recursos, timeouts e verificações de segurança.
Alternativa open source a:OpenAI Code Interpreter
- Estrelas
- 383
- Forks
- 39
- Issues abertas
- 9
- Último commit
- há 15 dias
O que é?
O AgentRun permite que uma aplicação envie código Python escrito por um modelo de linguagem grande para um ambiente isolado e receba o resultado, incluindo exceções e tracebacks. Ele é baseado no Docker Python SDK e no RestrictedPython, e o código é executado dentro de um container Docker isolado, não no sistema host.
Antes da execução, o código é verificado em busca de elementos perigosos. Os desenvolvedores podem controlar a cota de CPU, os limites de memória e swap e o timeout de execução (20 segundos por padrão), além de definir uma lista de permissões para os pacotes pip que podem ser instalados. Também é possível armazenar dependências em cache previamente na imagem do container para acelerar execuções posteriores, e os artefatos criados pelo código gerado são removidos automaticamente.
Há duas formas de usar o projeto: instalar o pacote pip e conectá-lo ao seu próprio container Docker em execução, ou clonar o repositório e iniciar a configuração incluída do Docker Compose, que disponibiliza um endpoint REST em /v1/run/ para chamadas de qualquer linguagem.
Recursos principais
- 01Verifica se há operações perigosas no código gerado antes de executá-lo.
- 02Executa código em um container Docker isolado.
- 03Permite configurar limites de CPU, memória, swap e timeout.
- 04Oferece lista de permissões e cache prévio para dependências pip.
- 05Inclui uma API REST com Docker Compose pronta para executar.
- 06Retorna os mesmos resultados e tracebacks de uma execução local do Python.
Casos de uso
- Permitir que um agente LLM execute código para responder a perguntas de matemática ou sobre dados.
- Adicionar um recurso de interpretador de código a um chatbot ou produto de IA.
- Hospedar por conta própria um serviço isolado de execução de código para ferramentas internas.
Início rápido
- 1
Clone o repositório do GitHub
git clone https://github.com/Jonathan-Adly/agentrun - 2
Acesse a pasta REST API
cd agentrun/agentrun-api - 3
Crie o arquivo de ambiente usando o exemplo
cp .env.example .env.dev - 4
Compile e inicie os serviços do Docker
docker-compose up -d --build
Antes de usar
- É necessário ter o Docker instalado e em execução.
- O pacote pip exige que você forneça seu próprio contêiner Docker em execução.
Em coleções
Tópicos
Perguntas frequentes
- O que é AgentRun?
- Uma biblioteca Python e uma API REST que executam código Python gerado por LLM em um container Docker isolado, com limites de recursos, timeouts e verificações de segurança. O AgentRun permite que uma aplicação envie código Python escrito por um modelo de linguagem grande para um ambiente isolado e receba o resultado, incluindo exceções e tracebacks. Ele é baseado no Docker Python SDK e no RestrictedPython, e o código é executado dentro de um container Docker isolado, não no sistema host.
- AgentRun é gratuito? Qual é a licença?
- AgentRun é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- AgentRun ainda é mantido?
- Manutenção ativa. O último commit de AgentRun foi em 23 de out. de 2026.
- Para que posso usar AgentRun?
- Permitir que um agente LLM execute código para responder a perguntas de matemática ou sobre dados. Adicionar um recurso de interpretador de código a um chatbot ou produto de IA. Hospedar por conta própria um serviço isolado de execução de código para ferramentas internas.
- Como instalar AgentRun?
- Clone o repositório do GitHub: git clone https://github.com/Jonathan-Adly/agentrun Acesse a pasta REST API: cd agentrun/agentrun-api Crie o arquivo de ambiente usando o exemplo: cp .env.example .env.dev Compile e inicie os serviços do Docker: docker-compose up -d --build
- Onde consigo AgentRun?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tjmlabs/AgentRun
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Serviço de sandbox open source para agentes de IA, com cada workload executado em uma MicroVM com isolamento por hardware, compatibilidade com o E2B SDK e inicialização em menos de 60 ms.
13,2 mil+75 esta semana1,2 milGoOtherBem mantidoAtualizado há 24 horas
Plataforma de sandbox que executa código de agentes e usuários em microVMs Firecracker isoladas, controladas por uma API HTTP.
2,1 mil+59 esta semana186RustApache-2.0Bem mantidoAtualizado há 14 horas
Infraestrutura self-hosted baseada em Kubernetes que executa código não confiável em sandboxes leves de VM, controlada por CLI, API HTTP e SDK Python.
825+1 esta semana26PythonApache-2.0Atualizado há 6 dias
Runtime de sandbox open source que oferece aos agentes de IA ambientes isolados para executar código, comandos, arquivos e navegadores na sua própria infraestrutura.
16,5 mil+176 esta semana1,6 milPythonApache-2.0Bem mantidoAtualizado há 20 horas
Sandbox Docker completo que oferece a agentes de IA um navegador, shell, sistema de arquivos, VSCode Server, Jupyter e serviços MCP compartilhados.
6,3 mil+45 esta semana567PythonApache-2.0Atualizado há 2 meses