Repolode
Enviar
jingkaihe

jingkaihe/matchlock

Uma CLI baseada em Linux que executa agentes de IA em microVMs efêmeras, com allowlist de rede e injeção de secrets pelo host.

Ver no GitHub
Estrelas
647
Forks
37
Issues abertas
3
Último commit
há 20 dias

O que é?

Matchlock é uma ferramenta de linha de comando para executar agentes de IA em microVMs descartáveis. Cada sandbox é um ambiente Linux completo que inicia em menos de um segundo, permitindo que o agente instale pacotes e grave arquivos sem tocar na máquina host. A VM é descartada ao fim da execução, e os mounts de overlay de volumes são snapshots isolados que desaparecem depois.

O acesso à rede fica restrito por padrão quando você passa --allow-host ou --secret: só é possível acessar os hosts listados explicitamente. Os secrets são injetados por um proxy TLS MITM no host, então o sandbox só vê um valor de placeholder, e a credencial real nunca entra na VM. O projeto também oferece suporte a sandboxes de longa duração com encaminhamento de portas, criação de imagens a partir de Dockerfiles com BuildKit dentro da VM e SDKs para Go, Python e TypeScript.

Funciona no Linux com KVM e no macOS com Apple Silicon, usando a mesma CLI em ambos. O projeto é marcado como experimental e pode ter mudanças incompatíveis.

Recursos principais

  • 01Executa agentes em microVMs efêmeras que iniciam em menos de um segundo.
  • 02Restringe o acesso à rede com uma allowlist, permitindo acesso apenas aos hosts listados.
  • 03Injeta API keys por meio de um proxy TLS MITM no host, para que os secrets nunca entrem na VM.
  • 04Oferece suporte a sandboxes de longa duração com exec, attach e encaminhamento de portas.
  • 05Cria imagens a partir de Dockerfiles usando BuildKit dentro da VM.
  • 06Disponibiliza SDKs para Go, Python e TypeScript.

Casos de uso

  • Permitir que um agente de programação com IA execute código arbitrário sem expor a máquina host.
  • Chamar APIs de LLMs de terceiros a partir do código do agente sem colocar as keys dentro do sandbox.
  • Executar scripts não confiáveis em um ambiente Linux descartável com tráfego de saída restrito.
  • Incorporar execução isolada de código a uma aplicação usando os SDKs.

Início rápido

  1. 1

    Toque no repositório do Homebrew

    brew tap jingkaihe/essentials
  2. 2

    Instale o matchlock com o Homebrew

    brew install matchlock
  3. 3

    Execute um comando de teste em uma microVM efêmera

    matchlock run --image alpine:latest cat /etc/os-release

Antes de usar

  • O projeto é experimental e pode passar por mudanças incompatíveis.
  • Ele só oferece suporte a Linux com KVM e macOS em Apple Silicon.
  • No Linux, a configuração do host pode exigir a execução de sudo matchlock setup linux.

Em coleções

Frameworks e apps de agentes de IA open sourceFerramentas de CLI e terminalFerramentas de varredura, auditoria e inteligência de ameaças

Tópicos

#ai-agents#sandbox#microvm#security#firecracker#network-isolation#secret-management#cli

Perguntas frequentes

O que é matchlock?
Uma CLI baseada em Linux que executa agentes de IA em microVMs efêmeras, com allowlist de rede e injeção de secrets pelo host. Matchlock é uma ferramenta de linha de comando para executar agentes de IA em microVMs descartáveis. Cada sandbox é um ambiente Linux completo que inicia em menos de um segundo, permitindo que o agente instale pacotes e grave arquivos sem tocar na máquina host. A VM é descartada ao fim da execução, e os mounts de overlay de volumes são snapshots isolados que desaparecem depois.
matchlock é gratuito? Qual é a licença?
matchlock é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
matchlock ainda é mantido?
Manutenção ativa. O último commit de matchlock foi em 4 de out. de 2026.
Para que posso usar matchlock?
Permitir que um agente de programação com IA execute código arbitrário sem expor a máquina host. Chamar APIs de LLMs de terceiros a partir do código do agente sem colocar as keys dentro do sandbox. Executar scripts não confiáveis em um ambiente Linux descartável com tráfego de saída restrito. Incorporar execução isolada de código a uma aplicação usando os SDKs.
Como instalar matchlock?
Toque no repositório do Homebrew: brew tap jingkaihe/essentials Instale o matchlock com o Homebrew: brew install matchlock Execute um comando de teste em uma microVM efêmera: matchlock run --image alpine:latest cat /etc/os-release
Onde consigo matchlock?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jingkaihe/matchlock

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

Projetos relacionados