El motor de juegos de rol en solitario de código abierto utiliza tres instancias de Claude para análisis, narración y dirección.

Arquitectura y Pipeline

EdgeTales es un motor de RPG en solitario basado en Python donde los jugadores escriben las acciones del personaje, la mecánica de dados resuelve los resultados detrás de escena y la IA Claude escribe prosa atmosférica basada en los resultados. El principio de diseño central es "la IA narra, no decide": los dados determinan el éxito o el fracaso, mientras que Claude solo convierte los resultados en historia.

El sistema utiliza un pipeline triple de IA con tres instancias de Claude por turno de jugador:

• Cerebro (Claude Haiku): Analiza la entrada de texto libre en JSON estructurado con campos como movimiento de RPG, estadística, NPC objetivo, nivel de posición/efecto. Toma ~300 ms y cuesta ~$0.0002.
• Narrador (Claude Sonnet): Recibe indicaciones estructuradas con resultados de dados, contexto de NPC y arco argumental, luego escribe prosa atmosférica. También incrusta metadatos ocultos (<new_npcs>, <memory_updates>) que el analizador extrae para actualizaciones del estado del juego. Toma ~2 s y cuesta ~$0.003.
• Director (Claude Haiku): Se ejecuta de forma asíncrona después de que el jugador ve la narración. Analiza escenas como un showrunner de TV para obtener pistas sobre el comportamiento de los NPC, seguimiento de hilos argumentales y resúmenes de escenas. Solo se activa en eventos específicos (tiradas fallidas, nuevos NPC, cada 3ª escena) con latencia cero para el jugador.

El costo total por turno es de ~$0.003–0.004, lo que hace que una sesión de 20 escenas cueste ~6–8 centavos. La salida del Director va a las etiquetas <director_guidance> en la siguiente indicación del Narrador, con degradación elegante si el Director falla.

Detalles de Implementación Técnica

Lecciones de Ingeniería de Indicaciones:

• La inyección de contexto XML estructurado (<world>, <character>, <npc>, <story_arc>, <director_guidance>) hizo que la salida de Sonnet fuera más consistente que las instrucciones en prosa.
• Haiku es efectivo para el análisis estructurado: el Cerebro devuelve JSON válido con 8+ campos a partir de entrada multilingüe de forma libre.
• La reparación de JSON es esencial. Ambos modelos ocasionalmente producen JSON mal formado (comas faltantes en texto alemán, saltos de línea sin escape, comas finales). Una función _repair_json() con enfoque de intento primero maneja esto con sobrecarga cero para JSON válido.
• La deduplicación de NPC utiliza tres redes de seguridad: etiquetas explícitas <npc_rename>, coincidencia aproximada de subcadenas antes de la creación y búsqueda consciente de alias.

Sistema de Memoria de NPC: Cada NPC tiene memoria ponderada por importancia calculada como Puntuación = 0.40 × Reciente + 0.35 × Importancia + 0.25 × Relevancia. El Director genera "reflexiones" (cómo se siente un NPC) junto con observaciones fácticas. La memoria se mantiene limitada a 25 entradas por NPC con consolidación inteligente.

Pila Técnica: Python 3.11+, NiceGUI, SDK de Anthropic, EdgeTTS/Chatterbox (TTS), Faster-Whisper (STT). La base de código tiene ~6,800 líneas en 5 archivos. Las características incluyen 20+ idiomas de narración, E/S de voz, exportación a PDF, modo apto para niños y compatibilidad con Raspberry Pi.