llm-gamebook

LLM Gamebook é um framework para a criação de histórias interativas onde as narrativas são geradas por Large Language Models (LLMs) enquanto seguem um grafo estruturado de caminhos de história. Ele utiliza uma arquitetura de monorepo composta por um backend FastAPI e um frontend React. Os principais componentes técnicos incluem: - StoryEngine & EngineManager: Gerenciam as interações dos agentes LLM, o histórico de mensagens e o pooling de instâncias. - StoryContext & SessionState: Gerenciam as definições do projeto, traços de entidades e rastreiam o progresso do jogador através de transições de nós do grafo. - MessageBus: Um sistema assíncrono de pub/sub para gerenciar os ciclos de vida do engine e eventos de sessão. - ProjectManager: Lida com o carregamento de definições de história a partir de arquivos YAML. As histórias são definidas via YAML, permitindo que os desenvolvedores especifiquem tipos de entidades, arcos de história baseados em grafos, locais, personagens e funções de ferramenta que o LLM pode chamar para disparar transições de estado. A stack tecnológica inclui FastAPI, SQLModel (aiosqlite), Pydantic AI para chamadas de ferramentas e Jinja2 para templates de prompt no backend, com um frontend em React 19, TypeScript e Mantine UI.