llm-gamebook

LLM Gamebook es un marco para crear historias interactivas donde las narrativas son generadas por Modelos de Lenguaje Extensos (LLMs) mientras siguen un grafo estructurado de rutas de historia. Utiliza una arquitectura de monorepo que consiste en un backend de FastAPI y un frontend de React. Los componentes técnicos clave incluyen: - StoryEngine y EngineManager: Gestionan las interacciones de los agentes LLM, el historial de mensajes y el pooling de instancias. - StoryContext y SessionState: Administran las definiciones del proyecto, los rasgos de las entidades y rastrean el progreso del jugador a través de las transiciones de nodos del grafo. - MessageBus: Un sistema asíncrono de pub/sub para gestionar los ciclos de vida del motor y los eventos de sesión. - ProjectManager: Se encarga de la carga de las definiciones de historia desde archivos YAML. Las historias se definen a través de YAML, lo que permite a los desarrolladores especificar tipos de entidades, arcos de historia basados en grafos, ubicaciones, personajes y funciones de herramientas que el LLM puede llamar para activar transiciones de estado. El stack tecnológico incluye FastAPI, SQLModel (aiosqlite), Pydantic AI para la llamada de herramientas y Jinja2 para el plantillado de prompts en el backend, con un frontend de React 19, TypeScript y Mantine UI.