Zeltro CLI

Zeltro es un gestor de entornos de desarrollo local basado en Docker para proyectos PHP, Python y Node, y a la vez un conjunto de barreras de protección para los agentes de IA que programan en tu equipo.

Hace tres cosas, y cada una refuerza a las demás.

Comparte un solo conjunto de servicios entre todos los proyectos#

Un zeltro-postgres, un zeltro-mariadb, un zeltro-redis, un zeltro-mongo y un zeltro-memcached, compartidos por todos los proyectos de Zeltro del equipo. Aunque tengas diez proyectos en marcha, sigues teniendo como máximo uno de cada.

• Los proyectos se comunican entre sí por nombre. Todos los proyectos se unen a una misma red de Docker y se resuelven por nombre en ella, así que un contenedor puede hacer fetch('http://my-api/') o psql -h zeltro-postgres sin configurar nada de red.
• Se acabó la ruleta de puertos. Nunca eliges un puerto. Cada proyecto recibe su propia dirección al crearse, y zeltro status la muestra: nada de localhost:3001 contra :3002 contra :3003, ni trucos con host.docker.internal.
• Recursos consolidados. Siete contenedores de Postgres duplicados que consumen ~700MB pasan a ser uno que consume ~100MB.
• Sin conflictos. Cuando el archivo compose de un proyecto trae su propia base de datos o caché (Postgres en 5432, MySQL en 3306, Redis, etc.), Zeltro quita ese servicio y conecta la app al compartido.

Entornos de ejecución ya preparados#

Tres imágenes base cubren todos los stacks compatibles: PHP 8.3, Python 3 y Node 22. Cada una ejecuta nginx bajo supervisor.

Nunca tienes que buscar una imagen, comparar etiquetas ni escribir un Dockerfile. La imagen de PHP trae compiladas las extensiones de MySQL, PostgreSQL, SQLite, Redis y MongoDB. La imagen de Python trae los drivers de las cinco, además de Django, Flask, FastAPI, gunicorn y uvicorn. La imagen de Node incluye las herramientas de compilación que npm necesita para los drivers nativos.

Consulta Arquitectura para ver qué incluye cada imagen.

Pensado para que los agentes de IA trabajen dentro#

Si lo dejas a su aire, un agente de IA monta el proyecto como le parece: sus propios puertos, su propia base de datos empaquetada, su propio archivo compose, sin tener en cuenta los otros doce proyectos de tu equipo. Zeltro le da al agente un entorno fijo en el que trabajar:

• Una plataforma estable. Servicios compartidos, una sola red, direcciones asignadas e imágenes de ejecución conocidas hacen que el agente construya tu app en lugar de reinventar la infraestructura.
• Menos tokens. El andamiaje de frameworks, la red, la generación de secretos y más de 200 instalaciones de apps ya vienen resueltos. El agente no tiene que redescubrir en cada sesión cómo conectar nginx con php-fpm.
• Un contexto que perdura. Cuando Zeltro le entrega un proyecto a tu agente de IA, escribe un AGENTS.md que describe la dirección del proyecto, su base de datos y sus comandos, para que una sesión nueva del agente pueda retomar el proyecto desde cero.

Por dónde seguir#

Dónde Zeltro no aporta mucho#

Si solo tienes un proyecto y nunca tocas otro, un simple docker compose up te basta. Zeltro se gana su lugar cuando tienes varios proyectos, o un agente de IA, compartiendo el mismo equipo.

¿Encontraste un error en esta traducción? Avísanos en GitHub.