Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

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

Ver códigoProblemas y ayudaRepositorio ↗
00

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.

CASOS DE USO
  • 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
PUNTOS DESTACADOS
  • 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
PRECAUCIONES
  • 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
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA8 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

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.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.js
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
06

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.