storyloom

Storyloom é um motor de visual novel alimentado por IA que gera narrativa em tempo real. Ele usa um pipeline XML de streaming (StreamParser → StateManager → EventDispatcher) que analisa a saída do LLM linha a linha sem buffer, e um mecanismo de pré-busca de ponte que dispara a próxima chamada de API no meio do parágrafo para esconder a latência atrás do tempo de leitura. Principais capacidades incluem: - Dois modos de jogo: Texto e Gráfico, com escolhas dentro da cena além de bifurcações de rota no nível do esboço nos pontos de verificação - Sprites de personagens e fundos de cena com um pipeline de ativos que faz correspondência de catálogo O(1), fallback para LLM e geração assíncrona de IA - Validação de estado onde o LLM sugere gravações e o motor verifica tipos antes de aplicar; gravações rejeitadas são devolvidas ao modelo - Gerenciamento de contexto via janela deslizante, âncora permanente do prompt do sistema e compressão de ponto de verificação (~50K tokens) - Fluxo de co-criação onde a IA entrevista o usuário sobre sua ideia antes de gerar mundo, personagens e enredo - Salvamentos atômicos JSON que são agnósticos ao modo, permitindo alternar entre modo texto e gráfico a qualquer momento - Suporte i18n para inglês, chinês simplificado e chinês tradicional via gettext - Interface web construída em FastAPI + SSE + vanilla JS SPA, com janela de desktop nativa opcional via pywebview As opções de instalação incluem um binário autônomo (não requer Python), roda PyPI wheel (Python ≥ 3.10) e a partir do código-fonte. Extras opcionais adicionam suporte para janela de desktop nativa e remoção de fundo para imagens geradas usando onnxruntime. O projeto é licenciado sob MIT e segue a convenção Python stdlib-first com Commits Conventionais.