Repolode
jingkaihe

jingkaihe/matchlock

CLI para Linux que ejecuta agentes de IA en microVM efímeras, con hosts permitidos en la red e inyección de secretos desde el host.

Estrellas
647
Forks
37
Issues abiertos
3
Último commit
hace 20 días

¿Qué es?

Matchlock es una herramienta de línea de comandos para ejecutar agentes de IA en microVM desechables. Cada sandbox es un entorno Linux completo que arranca en menos de un segundo, por lo que un agente puede instalar paquetes y escribir archivos sin tocar la máquina host. La VM se descarta al terminar la ejecución, y los montajes de volúmenes overlay son snapshots aislados que desaparecen después.

El acceso a la red está restringido de forma predeterminada al usar --allow-host o --secret: solo se puede acceder a los hosts incluidos explícitamente en la lista. Los secretos se inyectan mediante un proxy TLS MITM en el host, así que el sandbox solo ve un valor de marcador de posición y la credencial real nunca entra en la VM. El proyecto también admite sandboxes de larga duración con reenvío de puertos, la creación de imágenes a partir de Dockerfiles mediante BuildKit dentro de la VM y SDK para Go, Python y TypeScript.

Funciona en Linux con KVM y en macOS con Apple Silicon, usando la misma CLI en ambos. El proyecto se considera experimental y puede introducir cambios incompatibles.

Funciones clave

  • 01Ejecuta agentes en microVM efímeras que arrancan en menos de un segundo.
  • 02Restringe el acceso a la red mediante una lista de hosts permitidos.
  • 03Inyecta claves de API mediante un proxy TLS MITM en el host, para que los secretos nunca entren en la VM.
  • 04Admite sandboxes de larga duración con exec, attach y reenvío de puertos.
  • 05Crea imágenes a partir de Dockerfiles mediante BuildKit dentro de la VM.
  • 06Ofrece SDK para Go, Python y TypeScript.

Casos de uso

  • Permitir que un agente de programación con IA ejecute código arbitrario sin exponer la máquina host.
  • Llamar a las API de LLM de terceros desde el código del agente sin guardar las claves dentro del sandbox.
  • Ejecutar scripts no confiables en un entorno Linux desechable con tráfico de salida restringido.
  • Integrar la ejecución aislada de código en una aplicación mediante los SDK.

Inicio rápido

  1. 1

    Toca el repositorio de Homebrew

    brew tap jingkaihe/essentials
  2. 2

    Instala matchlock con Homebrew

    brew install matchlock
  3. 3

    Ejecuta un comando de prueba en una microVM efímera

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

Antes de usarlo

  • El proyecto es experimental y puede sufrir cambios incompatibles.
  • Solo es compatible con Linux con KVM y macOS en Apple Silicon.
  • En Linux, la configuración del host puede requerir ejecutar sudo matchlock setup linux.

En colecciones

Temas

Preguntas frecuentes

¿Qué es matchlock?
CLI para Linux que ejecuta agentes de IA en microVM efímeras, con hosts permitidos en la red e inyección de secretos desde el host. Matchlock es una herramienta de línea de comandos para ejecutar agentes de IA en microVM desechables. Cada sandbox es un entorno Linux completo que arranca en menos de un segundo, por lo que un agente puede instalar paquetes y escribir archivos sin tocar la máquina host. La VM se descarta al terminar la ejecución, y los montajes de volúmenes overlay son snapshots aislados que desaparecen después.
¿matchlock es gratuito? ¿Qué licencia tiene?
matchlock es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿matchlock sigue mantenido?
Mantenimiento activo. El último commit de matchlock fue el 4 oct 2026.
¿Para qué puedo usar matchlock?
Permitir que un agente de programación con IA ejecute código arbitrario sin exponer la máquina host. Llamar a las API de LLM de terceros desde el código del agente sin guardar las claves dentro del sandbox. Ejecutar scripts no confiables en un entorno Linux desechable con tráfico de salida restringido. Integrar la ejecución aislada de código en una aplicación mediante los SDK.
¿Cómo se instala matchlock?
Toca el repositorio de Homebrew: brew tap jingkaihe/essentials Instala matchlock con Homebrew: brew install matchlock Ejecuta un comando de prueba en una microVM efímera: matchlock run --image alpine:latest cat /etc/os-release
¿Dónde consigo matchlock?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/jingkaihe/matchlock

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados