Yggdrasil — Ecosistema de Nueve Reinos
Nueve Reinos. Un Árbol.
Yggdrasil es un ecosistema de proyectos personales organizado bajo la metáfora de los Nueve Reinos nórdicos. En su corazón yace Lilith v5.0 — un agente CLI de fantasía oscura con memoria híbrida, inteligencia de enjambre, protocolo MCP, soporte multi-proveedor LLM, sistema de habilidades, modo por lotes y un panel de control en tiempo real.
$ git clone https://github.com/BrierAinz/Yggdrasil.git
$ cd Yggdrasil
$ cp Asgard/Lilith/.env.example Asgard/Lilith/.env
$ cd Asgard/Lilith && lilith
¿Qué es Yggdrasil?
Yggdrasil no es un monorepo — es un ecosistema vivo donde cada proyecto tiene un propósito, un ciclo de vida y un reino de destino. Inspirado en la cosmología nórdica, cada reino cumple una función distinta en el ciclo de desarrollo.
᛭ Principios Clave
- Un Proyecto, Un Reino: Cada proyecto reside en exactamente un reino en todo momento. No hay duplicados ni caos.
- Ciclo de Vida Estricto: El ciclo de vida se impone: Idea → Muspelheim → [Reino Destino] → Helheim (si muere).
- Lilith la Orquestadora: Un agente local impulsado por LLM con control vía Telegram, memoria RAG y delegación a sub-agentes.
- Enfoque API-First: Toda la comunicación con la IA fluye a través de un REST Gateway. Sin dependencias en la nube para el núcleo.
Los Nueve Reinos
Cada reino tiene un propósito único y bien definido. Los proyectos migran entre reinos a medida que evolucionan, siguiendo reglas estrictas definidas en REGLAS_YGGDRASIL.md.
| Reino | Tema | Propósito |
|---|---|---|
| Asgard | Tecnología Central | Proyectos centrales permanentes — Lilith, Gateway, Proveedores LLM |
| Vanaheim | Agentes IA | Bots, perfiles de agentes, protocolos de comunicación |
| Alfheim | Prototipos UI | Experimentos visuales, integraciones de IDE |
| Svartalfheim | Conocimiento | Documentación, decisiones de arquitectura, guías de despliegue |
| Muspelheim | Desarrollo Activo | Plantillas de sprint, hotfixes, trabajo activo |
| Niflheim | Recursos | Datasets, checkpoints de modelos, datos de entrenamiento |
| Midgard | Apps Personales | Aplicaciones completas y puestas a prueba |
| Jotunheim | Proyectos Masivos | Proyectos a largo plazo y de gran escala |
| Helheim | Cementerio | Código archivado, versiones legadas, basura regenerable |
Lilith — La Joya de la Corona de Asgard
La joya de la corona de Asgard. Un asistente de IA local que se ejecuta íntegramente en tu hardware a través de LM Studio, sin ataduras a la nube. Contróla desde cualquier lugar mediante Telegram.
Flujo de Peticiones:
Tú (Telegram) → Bot de Telegram → Gateway (FastAPI) → Lilith (Orquestadora) → LM Studio (LLM Local)
Características
- ᛒ Memoria Híbrida — Embeddings vectoriales + grafo de conocimiento + búsqueda de texto completo (FTS5). Compresión automática, extracción de entidades y recuerdo semántico entre sesiones.
- ᚹ Inteligencia de Enjambre — Agentes especialistas impulsados por LLM (investigador, programador, escritor, crítico) con bloqueo de archivos, resolución de conflictos y sesiones persistentes vía SQLite.
- ᛏ Programador de Tareas — Programación de trabajos estilo Cron con backend SQLite persistente y exposición de API REST.
- ᛇ Múltiples Proveedores LLM — LM Studio (local) + Kimi (remoto) + cualquier proveedor compatible con OpenAI. Respaldo automático, auto-detección de modelos y arranque sin configuración.
- ᚦ Habilidades y MCP — Paquetes de habilidades con recarga en caliente y auto-activación. El Protocolo MCP conecta servidores de herramientas externas de forma dinámica. Más de 35 herramientas nativas.
- ᚠ Arquitectura de Plugins — Herramientas conectables en caliente con descubrimiento dinámico, activación/desactivación y registro de herramientas personalizadas.
- ᛗ Panel en Tiempo Real — Panel web con actualizaciones en vivo vía WebSocket, diseño de múltiples paneles, widget de terminal y monitoreo del sistema. Estética de fantasía oscura.
- ᚨ Configuración TOML y Resiliencia — Configuración unificada en
~/.lilith/config.toml. Interruptor automático, apagado seguro, seguimiento de errores y recuperación automática.
Agentes de Yggdrasil
Cuatro agentes activos impulsan el ecosistema, cada uno con una personalidad LLM especializada, un rol distinto y una ventana de contexto propia.
| Agente | Modelo Backend | Especialidad | Contexto |
|---|---|---|---|
| Shalltear | Venice AI (llama-3.3-70b) | Clasificación, análisis de lenguaje natural, triaje | 32k |
| Adán | Ollama (qwen2.5-coder:7b) | Generación de código, pruebas, refactorización | 8k |
| Eva | Grok (grok-4-fast-reasoning) | Análisis de largo contexto, documentación | 128k |
| Odín | Kimi (kimi-for-coding) | Análisis profundo, investigación, escritura creativa | 262k |
Componentes sin agente que complementan el panteón:
| Componente | Reino | Rol |
|---|---|---|
| Lilith | Asgard | Orquestadora central — Agente CLI con memoria híbrida, inteligencia de enjambre y control sobre sub-agentes |
| Bifrost | Vanaheim | Pasarela de Telegram — el puente arcoíris que conecta el ecosistema con el plano mortal |
| ForgeMaster | Muspelheim | Automatizador de builds — catálogo de modelos, detección de GPU, calculadora de VRAM |
| Dashboard | Alfheim | UI de terminal en tiempo real — métricas del sistema, actividad de Git, telemetría en vivo |
Salud del Ecosistema
Estado actual de los componentes principales en todos los reinos.
| Componente | Reino | Estado | Descripción |
|---|---|---|---|
| Lilith | Asgard | ᛏ Activo | Orquestadora central v5.0 — CLI, memoria, enjambre, MCP, habilidades, lotes, panel |
| Gateway | Asgard | ᛏ Activo | Puente REST de FastAPI que expone Telegram, Programador, Agentes, Plugins |
| ForgeMaster | Muspelheim | ᛏ Activo | Catálogo de modelos, detección GPU, metadatos GGUF/safetensors, gestor de descargas |
| TerminalDashboard | Alfheim | ᛏ Activo | Interfaz de terminal con escáner, actividad de Git, búsqueda lateral, paneles enriquecidos |
| Proveedores LLM | Asgard | ᛏ Activo | Múltiples proveedores: LM Studio (local), Kimi (remoto), compatibles con OpenAI, auto-respaldo |
| Memoria Híbrida | Asgard | ᛏ Activo | Embeddings + grafo de conocimiento + FTS5, auto-compresión, extracción de entidades |
| Int. de Enjambre | Asgard | ᛏ Activo | Agentes especialistas con bloqueo de archivos, resolución de conflictos, sesiones SQLite persistentes |
| Habilidades y MCP | Asgard | ᛏ Activo | Paquetes recargables en caliente, protocolo MCP, registro dinámico de herramientas, 35+ herramientas nativas |
| Programador | Asgard | ᛏ Activo | Programación estilo Cron con API REST y almacenamiento persistente |
| Panel de Control | Asgard | ᛏ Activo | Panel web en tiempo real con WebSocket, diseño de múltiples paneles, widget de terminal |
| Config. y Resiliencia | Asgard | ᛏ Activo | Config unificada, interruptor automático, apagado seguro, seguimiento de errores, auto-recuperación |
| Bot de Telegram | Vanaheim | ᛏ Activo | Interfaz de control remoto para todo el ecosistema |
| Extensión VSCode | Alfheim | ᚦ Prototipo | Interfaz visual para Lilith dentro de VS Code |
| Sitio Web | Svartalfheim | ᛏ Activo | Sitio de documentación de GitHub Pages (esta página) |