Lilith v5.0

Un agente CLI de fantasía oscura forjado en los fuegos antiguos de Yggdrasil. Memoria híbrida, inteligencia de enjambre, protocolo MCP, soporte multi-proveedor LLM, modo por lotes, habilidades recargables en caliente y panel de control en tiempo real. Sin ataduras a la nube. Sin suscripciones. Controla tu reino desde Telegram o la terminal.

$ cd Asgard/Lilith
$ cp .env.example .env      # Configura tus claves de API
$ lilith                    # Ejecuta desde cualquier lugar

¿Por qué local?

Lilith está forjada bajo un principio antiguo: tus datos se quedan en tu salón. El LLM se ejecuta a través de LM Studio (localhost:1234). La memoria se almacena en SQLite local. Los archivos nunca salen de tu disco. Telegram es solo el cuervo mensajero — el cerebro reside en tu propia forja.

᛭ Datos Clave

• No requiere claves de API para el núcleo. LM Studio sirve el modelo localmente. Kimi está disponible como respaldo remoto.
• Funciona sin conexión una vez cargado LM Studio. Telegram necesita internet, pero el cerebro del agente no.
• 48GB RAM + RTX 3060 puede ejecutar modelos de hasta ~27B parámetros con descarga a CPU.
• Multi-proveedor — respaldo automático de LM Studio a Kimi o a cualquier API compatible con OpenAI.
• Auto-detección de modelos — "auto" en la configuración selecciona el mejor modelo cargado en LM Studio.
• 838 pruebas superadas — Core, Memory, Swarm, MCP, Dashboard, CLI, TOML Config, Batch, E2E.

Cómo funciona

Lilith v5.0 está organizada en Seis Reinos — cada uno un módulo con su propia ley, todos nutridos por las mismas raíces. La Orquestadora coordina Habilidades, Memoria, Proveedores LLM, Enjambre, MCP y Herramientas a través de una configuración TOML unificada.

Tú (Telegram) → Bot Telegram (Vanaheim) → [HTTP] → Gateway (FastAPI :8000) → Lilith (Orquestadora) → LM Studio (LLM Local)

El Gateway

El Gateway es el punto único de contacto para todas las interfaces externas. Expone endpoints REST para Telegram, operaciones de archivos, tareas programadas, agentes, plugins, memoria, enjambre, habilidades y MCP.

Endpoint	Método	Propósito
/api/telegram/chat	POST	Endpoint principal para mensajes de Telegram
/api/telegram/pregunta_rapida	POST	Preguntas rápidas (sin persistencia de contexto)
/api/telegram/confirm	POST	Confirmación humana
/api/pc/fs	GET/POST	Operaciones del sistema de archivos
/api/scheduler/tasks	GET/POST	Listar o crear tareas programadas
/api/agents	GET/POST	Listar o crear sub-agentes
/api/plugins	GET	Listar plugins y herramientas disponibles
/api/memory/*	Varios	Lectura/escritura/búsqueda de memoria vectorial
/api/swarm/*	GET/POST	Gestión del enjambre: creación, estado, historial
/api/skills	GET/POST	Listar habilidades, activar, recargar en caliente
/api/mcp	GET/POST	Estado de conexión y gestión del servidor MCP

Componentes Centrales

ᛒ Memoria Híbrida (FASE 2)

Memoria de tres capas: embeddings vectoriales (sentence-transformers), grafo de conocimiento (NetworkX) y búsqueda de texto completo (FTS5). Compresión automática, extracción de entidades y recuerdo semántico.

ᚨ LLM Multi-Proveedor (FASE 7)

LM Studio para inferencia local, Kimi (Moonshot) para remoto. Respaldo automático. Auto-detección de modelos vía /models. Arranque sin configuración.

ᚹ Inteligencia de Enjambre (FASE 9)

Crea agentes especialistas impulsados por LLM (investigador, programador, escritor, crítico). Bloqueo de archivos para evitar conflictos. Sesiones persistentes vía SQLite. /swarm spawn, /swarm status, /swarm history.

ᛏ Habilidades y MCP (FASE 8)

Paquetes de habilidades recargables en caliente. El Protocolo MCP conecta servidores de herramientas externas de forma dinámica. Más de 35 herramientas nativas.

ᛗ Programador de Tareas

Programación estilo Cron con almacenamiento SQLite persistente. Despierta al agente en el momento adecuado para ejecutar trabajos en segundo plano.

ᛇ Panel de Control en Tiempo Real (FASE 10)

Panel web con actualizaciones WebSocket, widget de terminal y monitoreo del sistema con estética de fantasía oscura.

ᚺ Arquitectura de Plugins

Herramientas conectables en caliente con descubrimiento dinámico. Registro dinámico que integra MCP y herramientas nativas.

ᛚ Pipeline RAG

Ingesta de documentos, embeddings vía sentence-transformers y recuperación semántica. Indexa con /index, busca con /search.

ᚦ Control de PC

Más de 35 herramientas nativas: sistema de archivos, gestión de procesos, interacción con navegador, control de escritorio.

ᛊ Configuración TOML y Resiliencia (FASE 10)

Configuración unificada en ~/.lilith/config.toml. Prioridad: TOML > env vars > defaults. Interruptor automático, apagado seguro y recuperación automática.

Comandos de CLI y Telegram

Controla Lilith a través de la CLI de la terminal o remotamente vía Telegram. Ambas interfaces comparten el mismo orquestador.

Comando	Descripción
/start	Iniciar el bot y mostrar mensaje de bienvenida
/status	Comprobar salud del Gateway, memoria y agentes
/memory	Inyectar una entrada en la base de datos vectorial
/tasks	Listar tareas programadas
/swarm spawn <tarea>	Crear un enjambre de agentes especialistas
/skills	Listar paquetes de habilidades registrados
/mcp	Mostrar estado de los servidores MCP
/recall <query>	Búsqueda semántica en todas las memorias
/index <ruta>	Indexar archivos/carpetas para búsqueda RAG
/dashboard	Iniciar/detener el panel web en tiempo real
/batch <prompt>	Ejecutar Lilith en modo por lotes

Especificaciones Recomendadas

	Mínimo	Recomendado	Equipo de Referencia
RAM	16GB	32GB+	48GB DDR4
CPU	Moderno	6+ núcleos	AMD Ryzen 5 5500
GPU	—	NVIDIA 12GB+	NVIDIA RTX 3060 12GB
Modelos	7B (Q4)	13-27B	27B cómodamente