docker-pibox
Contenedor Docker que envuelve pi-coding-agent sobre aicodebox, ofreciendo API HTTP compatible con OpenAI, servidor MCP, bot Telegram y cron. Ideal para automatización local o remota con modelos GLM-4.6 vía Z.AI o Anthropic. Incluye wrapper instalador para gestión simplificada de estado y mounts.
Ficha actualizada 23 sept 2026, 20:20 · upstream 23 sept 2026, 20:00 · release v0.18.3
Qué es docker-pibox
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
docker-pibox es una imagen Docker construida sobre aicodebox que encapsula un agente de codificación (pi-coding-agent). Proporciona múltiples interfaces de interacción: un servidor HTTP API compatible con OpenAI, un servidor MCP para agentes externos, un bot de Telegram y un programador cron. El proyecto incluye un instalador wrapper en el host que facilita la gestión del estado, SSH y configuraciones sin necesidad de construir manualmente el contenedor cada vez.
La arquitectura soporta múltiples modos operativos mutuamente excluyentes (API, Telegram, Cron), excepto cuando se combina con MCP. Utiliza FastAPI para el backend y permite configurar proveedores de LLM como Anthropic o Z.AI a través de variables de entorno. El sistema gestiona espacios de trabajo persistentes, autenticación y logs por ejecución, permitiendo una integración fluida en flujos de desarrollo existentes.
Las integraciones incluyen habilidades nativas para agentes como Claude Code y Codex, facilitando la conexión directa con el agente pi sin exponer credenciales sensibles. La imagen minimalista requiere pocos recursos (1 core CPU, 1 GB RAM) pero ofrece una versión completa opcional con herramientas de desarrollo preinstaladas.
- Servidor API local para agentes externos que requieren llamadas chat/completions.
- Bot de Telegram para control remoto y ejecución de comandos en el workspace.
- Programador cron para tareas automatizadas periódicas (ej. análisis nocturno).
- Integración como herramienta MCP para orquestadores de IA existentes.
- Entorno de desarrollo ligero para pruebas rápidas con modelos Z.AI o Anthropic.
- Soporte nativo para múltiples modos operativos (API, Telegram, Cron, MCP) en una sola imagen.
- Instalador wrapper simplificado que gestiona mounts, estado y variables de entorno automáticamente.
- Compatibilidad verificada con proveedores como Anthropic y Z.AI (GLM-4.6).
- Integración directa con agentes populares como Claude Code y Codex vía marketplace.
- Bajo consumo de recursos (1 GB RAM) adecuado para despliegues en máquinas modestas.
- No incluye Docker Compose nativo, requiere gestión manual del ciclo de vida del contenedor.
- La versión mínima no incluye la cadena de herramientas de desarrollo completa (requiere imagen full).
- Dependencia de variables de entorno específicas (PIBOX_*) que pueden ser complejas de gestionar en orquestadores sin soporte.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar el instalador wrapper es la vía recomendada para evitar errores de montaje. Configurar PIBOX_API_MODE=1 para servir API o PIBOX_TELEGRAM_MODE=1 para bot. Asegurar que PIBOX_AVAILABLE_MODELS esté definido en modo API. Para despliegues persistentes, usar PIBOX_DETACH=1.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.