Sandboxes Autoalojados de Agentes IA: p9m (p7y) y Mastra
Aísla agentes de código en tu servidor: Purgatorium (p9m, antes p7y) da un Docker y URL por agente, y Mastra Factory convierte issues en PRs.
7 min de lectura

Ejecutar un agente de programación en tu portátil funciona bien hasta que lanzas tres en paralelo. Uno intenta ocupar el puerto 3000 que ya usa otro, un tercero lanza docker compose down -v sobre la base de datos equivocada y acabas cuidando entornos en vez de revisar código.
Dos proyectos open source atacan mitades complementarias de este problema en tu propia infraestructura: Purgatorium (p9m, antes p7y) entrega a cada desarrollador y agente IA su propio sandbox Docker-in-Docker con URL pública y suspensión por inactividad, mientras Mastra Factory (mastra-ai/template-factory) convierte tickets de GitHub, Linear, Jira y Slack en planes, implementaciones y pull requests revisados.
Aquí tienes cómo funciona cada uno, cómo desplegarlos en un VPS sin exponer el host y cuándo combinar ambos.
Dos capas distintas del stack autoalojado de agentes
Se suelen mezclar “sandboxes de agentes” y “factorías de agentes”, pero resuelven tareas distintas:
| Pieza | Purgatorium (p9m, antes p7y) |
Mastra Factory |
|---|---|---|
| Repo y licencia | csakaszamok/p9m (AGPL-3.0) | mastra-ai/template-factory (Apache-2.0) |
| Función principal | Sandbox Docker efímero por rama/agente con URLs de preview | Factoría de software de issue a PR (triaje, plan, código, revisión) |
| Aislamiento | Sysbox rootless DinD o microVMs Kata por sandbox | Sandboxes de plataforma Mastra o LocalFactorySandbox |
| Ahorro en reposo | Duerme sandboxes ociosos con Sablier y despierta en menos de 10s | Servidor Node.js persistente + PostgreSQL (pgvector) |
| Integración con agentes | API HTTP, servidor MCP y plugin oficial de Claude Code (p9m-team/p9m) |
Agentes Mastra + disparadores de GitHub, Linear, Jira y Slack |
| Mejor encaje | Dejar que Claude Code o Codex levanten apps Compose con URLs seguras | Convertir backlogs o menciones en Slack en PRs revisados |
Sobre el cambio de nombre de p7y a p9m
Si viste este proyecto en tendencias de GitHub como p7y-dev/p7y, el repositorio ahora vive en csakaszamok/p9m (Purgatorium) con redirección automática. Su imagen oficial es ghcr.io/csakaszamok/p9m:0.21.1 (pre-1.0, con changelog activo y posibles cambios entre versiones menores).
Parte 1: Purgatorium (p9m), un demonio Docker y una URL por agente
La mayoría de guías para encerrar agentes en contenedores (como mi guía de entorno seguro para CLI de IA) aíslan una sola shell, lo cual falla en cuanto el agente necesita lanzar docker compose up con Postgres y Redis. Montar /var/run/docker.sock dentro del contenedor del agente equivale a entregar root en el host.
Purgatorium resuelve esto colocando Sysbox (o microVMs Kata Containers) bajo cada sandbox. Cada sandbox recibe su propio demonio Docker privado, su URL https://<nombre>.<tu-dominio> a través de Traefik, direcciones TCP TLS para Postgres/Redis/SSH y Sablier para dormir entornos sin tráfico y despertarlos al siguiente acceso HTTP en menos de 10 segundos.
También incluye un registro de contenedores con escaneo de secretos, tokens limitados a un solo sandbox, un servidor MCP (JSON-RPC sobre HTTP) y un plugin de Claude Code para que el agente cree y compruebe sus propios entornos sin tocar el panel de administración.
Probar p9m en local vs desplegar en un VPS Linux
Prueba local (lvh.me)
Con Docker Engine (o Docker Desktop) y los puertos 80 y 443 libres:
mkdir p9m && cd p9m
curl -fsSLO https://github.com/csakaszamok/p9m/releases/latest/download/docker-compose.yml
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/setup.sh | bash
docker compose up -dsetup.sh crea secretos aleatorios en .env e imprime la contraseña de administrador. Abre http://p9m.lvh.me (lvh.me apunta todos sus subdominios a 127.0.0.1, sin tocar DNS) y pulsa New sandbox. El primero tarda un minuto descargando imágenes base; los siguientes arrancan en ~10 segundos.
VPS Linux en producción (Sysbox)
En un VPS Linux (por ejemplo un servidor configurado como en mi guía de VPS para codificación con IA), instala Sysbox primero para mantener ALLOWED_RUNTIMES=sysbox en lugar de dind privilegiado. Ejecuta primero la auditoría del host:
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/check-host.sh | bash -s -- dev.example.comDespués inicializa con tu dominio wildcard (*.dev.example.com apuntando al VPS):
mkdir p9m && cd p9m
curl -fsSLO https://github.com/csakaszamok/p9m/releases/latest/download/docker-compose.yml
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/setup.sh | bash -s -- dev.example.com
docker compose up -d
# Repite la comprobación para detectar cualquier ajuste inseguro pendiente
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/check-host.sh | bashPara conectarlo con Claude Code, añade el marketplace oficial (p9m-team/p9m):
/plugin marketplace add p9m-team/p9m
/p9m:init https://sbx.dev.example.comUna regla de seguridad sacada del propio docker-compose.yml de p9m: mantén ALLOWED_RUNTIMES=sysbox (o sysbox,kata si dispones de virtualización anidada o bare metal). No actives dind privilegiado en servidores compartidos porque root dentro del sandbox podría alcanzar el host.
Parte 2: Mastra Factory, Kanban agéntico autoalojado de issue a PR
El equipo detrás de Mastra (el framework TypeScript que cubrí en crear un agente IA con Mastra y herramientas Mastra vs MCP) liberó el sistema interno con el que fusionaron 238 pull requests creados por agentes en una sola semana junto a 630 PRs humanos.
Mastra Factory no es una CLI interactiva. Es un servidor persistente (interfaz web y API) apoyado en PostgreSQL con pgvector que se conecta a GitHub, Linear, Jira y Slack. Sincronizas issues en Work -> Intake (o mencionas al bot en Slack) y Factory ejecuta un flujo ordenado: investiga el repo, redacta un plan para revisión humana, implementa en un sandbox, abre el PR y responde a los comentarios de revisión automáticamente.
Crear un Mastra Factory autoalojado (sin Mastra Cloud)
Por defecto, npm create factory enlaza con la nube de Mastra. Pasa --no-platform para generar la plantilla 100% autoalojada (mantén este proyecto separado de los repositorios que los agentes modificarán):
npm create factory -- --no-platform
cd my-factoryGenera una clave de cifrado persistente para las claves API y guárdala a buen recaudo:
openssl rand -base64 32Define al menos estas variables en .env:
DATABASE_URL=postgresql://user:[email protected]:5432/factory
FACTORY_CREDENTIAL_ENCRYPTION_KEY=pega-aqui-tu-clave-base64-de-32-bytes
MASTRACODE_PUBLIC_URL=https://factory.example.comDATABASE_URL exige PostgreSQL con la extensión pgvector. Si necesitas levantarlo rápido con Docker Compose, usa mi guía para desplegar pgvector y pgAdmin en Docker (y revisa novedades de PostgreSQL 19 antes de fijar etiqueta para confirmar compatibilidad de paquetes).
Para ejecución local en tu propia máquina o contenedor, pasa new LocalFactorySandbox() de @mastra/factory a MastraFactory en src/mastra/index.ts. Si activas Slack, recuerda configurar las cuatro variables (SLACK_APP_TOKEN o SLACK_APP_SIGNING_SECRET, además de SLACK_APP_BOT_TOKEN, SLACK_APP_CLIENT_ID y SLACK_APP_CLIENT_SECRET); una configuración parcial detiene el arranque a propósito en lugar de desactivar Slack en silencio.
Compila y arranca el servidor:
npm install
npm run build
npm run startAbre la interfaz, conecta tu GitHub App en Settings -> Work Intake -> GitHub issues, añade un proveedor de modelos y pruébalo primero con una tarea pequeña de documentación o tests.
Límites obligatorios antes de soltar agentes en tu VPS
- Limita CPU, RAM y cuotas por sandbox. En
p9majustaSANDBOX_CPUS(2),SANDBOX_MEMORY(4g),SANDBOX_DISK(20g) ySANDBOX_QUOTA(3 por usuario) para evitar que un bucle de compilación tumbe el VPS. - No uses
dindprivilegiado en producción. Instala Sysbox o Kata Containers siempre que el servidor aloje más de una prueba desechable. - Mantén la aprobación humana para merge. Deja que los agentes redacten, prueben y corrijan lint, con protección de ramas y CI obligatorios.
- Cierra puertos y controla accesos OIDC. Termina TLS con Traefik o Caddy, restringe
OIDC_ALLOWED_EMAILSy recuerda que Docker se salta UFW si expones0.0.0.0. - Respalda la clave de cifrado de Factory y Postgres. Perder
FACTORY_CREDENTIAL_ENCRYPTION_KEYinutiliza todas las credenciales guardadas en la base de datos.
Cuándo usar cada uno
Si ya trabajas feliz con tu CLI interactiva (Claude Code, OpenCode o Codex) y solo necesitas un entorno autoalojado donde cada agente levante stacks Compose con enlaces de preview seguros, Purgatorium (p9m) cubre un hueco muy concreto.
Si gestionas un repositorio de equipo con flujo constante de pequeños arreglos y tareas desde GitHub o Slack, Mastra Factory encaja mejor, sobre todo si tu stack ya es TypeScript y PostgreSQL.
Preguntas frecuentes
¿Por qué p7y redirige a p9m en GitHub?
El autor renombró el proyecto de p7y a Purgatorium (p9m) en github.com/csakaszamok/p9m. La URL antigua redirige automáticamente, mientras que el marketplace del plugin de Claude Code sigue llamándose p9m-team/p9m.
¿Mastra Factory funciona sin Mastra Cloud?
Sí. Inicializa con npm create factory -- --no-platform, apunta DATABASE_URL a tu propio PostgreSQL con pgvector, configura LocalFactorySandbox en src/mastra/index.ts y ejecútalo detrás de HTTPS en tu servidor.
¿Cuánta RAM necesita un VPS para sandboxes de p9m?
Calcula al menos 8–16 GB de RAM en un VPS Linux. El plano de control consume poco y cada sandbox activo usa hasta 4 GB por defecto (SANDBOX_MEMORY=4g). Como Sablier suspende los inactivos automáticamente, 16 GB dan margen cómodo para varias ramas a la vez.
¿Funciona p9m en Windows o macOS?
Sí para pruebas locales con Docker Desktop y dominios lvh.me. Para aislamiento real multiusuario con Sysbox o Kata Containers necesitas un host Linux con Docker Engine.
¿Te funcionó esta guía?
¿Necesitas ayuda con Astro, VPS o una app self-hosted? Ver servicios →


