storyloom

Storyloom es un motor de novela visual impulsado por IA que genera narración en tiempo real. Utiliza una tubería XML de streaming (StreamParser → StateManager → EventDispatcher) que analiza la salida del LLM línea por línea sin almacenamiento en búfer, y un mecanismo de pre-búsqueda de puente que dispara la siguiente llamada a la API en medio del párrafo para ocultar la latencia detrás del tiempo de lectura. Las capacidades clave incluyen: - Dos modos de juego: Texto y Gráfico, con elecciones dentro de la escena más bifurcaciones de ruta a nivel de esquema en los puntos de control - Sprites de personajes y fondos de escena con una tubería de activos que realiza una coincidencia de catálogo O(1), un fallback de LLM y una generación de IA asíncrona - Validación de estado donde el LLM sugiere escrituras y el motor las verifica antes de aplicarlas; las escrituras rechazadas se retroalimentan al modelo - Gestión de contexto a través de una ventana deslizante, un ancla de prompt de sistema permanente y la compresión de puntos de control (~50K tokens) - Flujo de co-creación donde la IA entrevista al usuario sobre su idea antes de generar el mundo, los personajes y la trama - Guardados JSON atómicos que son agnósticos al modo, permitiendo el cambio entre los modos de texto y gráfico en cualquier momento - Soporte de i18n para inglés, chino simplificado y chino tradicional a través de gettext - Interfaz de usuario web construida sobre FastAPI + SSE + SPA de JS puro, con una ventana de escritorio nativa opcional a través de pywebview Las opciones de instalación incluyen un binario independiente (no se requiere Python), una rueda de PyPI (Python ≥ 3.10) y desde el código fuente. Los extras opcionales añaden soporte para ventanas de escritorio nativas y la eliminación de fondo para imágenes generadas usando onnxruntime. El proyecto tiene una licencia MIT y sigue una convención de Python de primera clase con commits convencionales.