air-gapped
Kit portátil para operaciones Kubernetes offline con agente IA local (llama.cpp + Codex). Permite generar comandos, debuggear y crear runbooks sin internet ni nube.
Ficha actualizada 24 sept 2026, 9:04 · upstream 24 sept 2026, 9:00 · release sin release detectada
Qué es air-gapped
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Air-Gapped Codex es un repositorio diseñado para entornos restringidos que requieren asistencia de IA sin conexión a internet. Funciona como un paquete autocontenido que emula una API compatible con OpenAI, permitiendo que el CLI de Codex interactúe con modelos locales ejecutados en la misma máquina o en servidores aislados.
Técnicamente, combina llama.cpp para inferencia en CPU (formato GGUF) y vLLM para GPU (formato safetensors), ambos sirviendo a través de un proxy que normaliza las llamadas. El modelo por defecto es Qwen 3.5-2B, optimizado para tareas de codificación y operaciones de sistemas.
El flujo de trabajo implica una configuración inicial en una máquina conectada (descarga de binarios y modelos) seguida del despliegue en el entorno objetivo mediante copia de directorio. Una vez activo, se ejecuta el servidor backend y el cliente Codex en terminales separados para tareas como generar YAMLs de Kubernetes o diagnosticar pods.
- Generación de comandos Kubernetes (kubectl) para debugging offline
- Creación de runbooks de troubleshooting sin acceso a documentación externa
- Asistencia en redacción de scripts de automatización local
- Evaluación de respuestas de modelos LLM en entornos seguros
- Funcionamiento completamente air-gapped tras el bootstrap inicial
- Soporte dual para CPU (llama.cpp) y GPU (vLLM) con un mismo proyecto
- Portabilidad mediante copia de directorio a medios físicos aprobados
- Modelo Qwen 3.5-2B optimizado para tareas de ingeniería de sistemas
- Requiere conexión a internet inicial para descargar binarios y modelos (bootstrap)
- Dependencia de herramientas externas como uv, curl y Codex CLI
- Rendimiento limitado por hardware local sin acceso a clusters remotos
- Configuración manual de puertos y variables de entorno para GPU
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.
Ejecutar ./bootstrap.sh en máquina con internet antes de copiar al entorno air-gapped. Verificar puertos 28080/28081 libres. Para GPU, usar USE_VLLM=1 y ajustar VLLM_GPU_MEM_UTIL si hay OOM. Mantener terminal del servidor abierto mientras se ejecutan tareas en Codex.
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.