ggrun
Launcher especializado para ejecutar modelos MoE grandes en configuraciones multi-GPU heterogéneas, calculando automáticamente la distribución óptima de tensores considerando VRAM, RAM y ancho de banda PCIe real para evitar OOM sin tuning manual.
Ficha actualizada 22 sept 2026, 18:02 · upstream 22 sept 2026, 17:50 · release v3.2.9
Qué es ggrun
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ggrun es un launcher diseñado para gestionar el despliegue de modelos MoE grandes que no caben cómodamente en una sola GPU. Analiza la disposición de tensores del archivo GGUF frente a la VRAM, RAM y ancho de banda por GPU disponible, generando un plan de carga que ajusta automáticamente la distribución entre memoria de video y host para evitar errores OOM sin necesidad de ajustar manualmente banderas complejas.
El proyecto se centra en tres objetivos principales: ejecutar modelos MoE grandes que no encajan perfectamente en VRAM, encontrar configuraciones rápidas y estables para el contexto y carga deseados, y habilitar workflows locales con Claude Code (Ultracode) mediante agentes paralelos, herramientas y contextos largos sin inferencia en la nube. No es un motor de inferencia, sino una capa de orquestación que lee el GGUF, construye un plan de lanzamiento para el backend seleccionado, verifica que el plan quepa y mantiene el comando generado visible.
Incluye funcionalidades avanzadas como detección de ancho de banda PCIe real en hardware NVIDIA (--detect --bandwidth), optimización automática de banderas con --ai-tune, reutilización de caché de contexto (--cache-reuse) para reducir latencia en loops de agentes, y compatibilidad con APIs OpenAI y Anthropic. Soporta múltiples backends: ik_llama.cpp CUDA (NVIDIA), llama.cpp Vulkan (AMD/Intel), Metal (macOS experimental) y CPU.
- Ejecutar modelos MoE grandes en rigs multi-GPU heterogéneos sin tuning manual de distribución de tensores
- Integrar inferencia local con Claude Code para workflows Ultracode con agentes paralelos y contexto compartido
- Optimizar automáticamente configuraciones de rendimiento con --ai-tune y cachear la mejor combinación
- Gestionar descargas, inspección TUI y despliegue de modelos GGUF en un flujo unificado
- Probar perfiles de hardware específicos (--spec auto) para garantizar estabilidad tras cambios físicos
- Calcula distribución automática de tensores considerando VRAM, RAM y ancho de banda PCIe real por GPU
- Soporta modelos MoE que no caben en una sola GPU mediante offload a RAM host controlado
- Integración nativa con Claude Code para workflows locales sin inferencia en la nube
- Detección de ancho de banda PCIe (--detect --bandwidth) para perfiles de hardware específicos
- Optimización automática (--ai-tune) que explora banderas seguras y cachea el ganador
- API OpenAI/Anthropic compatible para chat completions y endpoints personalizados
- Depende del backend llama.cpp subyacente; no es un motor de inferencia independiente
- Soporte macOS experimental sin releases oficiales ni bundles portables garantizados
- Perfiles de ancho de banda PCIe específicos requieren recalibración tras cambios físicos en el hardware
- No incluye Dockerfile, compose ni contenerización nativa (solo bundles portables para CUDA)
- Requiere instalación manual vía script y configuración del PATH en todos los sistemas
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.
Instalar mediante curl (Linux/macOS) o PowerShell (Windows). Ejecutar ggrun detect --bandwidth una vez en NVIDIA para perfilar topología real. Añadir al PATH y usar ~/ggrun/ggrun o el equivalente en Windows. No incluye Docker ni compose; usa bundles portables para CUDA. Verificar compatibilidad de backend (--server-bin) si se usan binarios personalizados.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.