Le moteur de RPG solo open-source utilise trois instances Claude pour l'analyse, la narration et la direction.

Architecture et Pipeline

EdgeTales est un moteur de jeu de rôle solo basé sur Python où les joueurs tapent les actions de leur personnage, la mécanique des dés résout les résultats en arrière-plan, et l'IA Claude écrit une prose atmosphérique basée sur les résultats. Le principe de conception fondamental est "l'IA narre, elle ne décide pas" — les dés déterminent le succès ou l'échec, tandis que Claude se contente de transformer les résultats en histoire.

Le système utilise un pipeline triple-IA avec trois instances Claude par tour de joueur :

• Cerveau (Claude Haiku) : Analyse l'entrée en texte libre pour la transformer en JSON structuré avec des champs comme action RPG, statistique, PNJ cible, niveau de position/effet. Prend ~300 ms et coûte ~0,0002 $.
• Narrateur (Claude Sonnet) : Reçoit des invites structurées avec les résultats des dés, le contexte des PNJ et l'arc narratif, puis écrit une prose atmosphérique. Intègre également des métadonnées cachées (<new_npcs>, <memory_updates>) que l'analyseur extrait pour mettre à jour l'état du jeu. Prend ~2 s et coûte ~0,003 $.
• Directeur (Claude Haiku) : Fonctionne de manière asynchrone après que le joueur a vu la narration. Analyse les scènes comme un showrunner de série télévisée pour obtenir des indices sur le comportement des PNJ, le suivi des fils narratifs et les résumés de scènes. Ne se déclenche que sur des événements spécifiques (jets de dés échoués, nouveaux PNJ, toutes les 3 scènes) avec une latence nulle pour le joueur.

Le coût total par tour est d'environ 0,003–0,004 $, ce qui fait qu'une session de 20 scènes coûte environ 6–8 cents. La sortie du Directeur est placée dans des balises <director_guidance> dans la prochaine invite du Narrateur, avec une dégradation gracieuse si le Directeur échoue.

Détails de mise en œuvre technique

Leçons d'ingénierie des invites :

• L'injection de contexte XML structuré (<world>, <character>, <npc>, <story_arc>, <director_guidance>) a rendu la sortie de Sonnet plus cohérente que les instructions en prose.
• Haiku est efficace pour l'analyse structurée — le Cerveau renvoie un JSON valide avec 8+ champs à partir d'une entrée multilingue en forme libre.
• La réparation JSON est essentielle. Les deux modèles produisent occasionnellement un JSON malformé (virgules manquantes dans le texte allemand, nouvelles lignes non échappées, virgules finales). Une fonction _repair_json() avec une approche "essayer d'abord" gère cela sans surcharge pour le JSON valide.
• La déduplication des PNJ utilise trois filets de sécurité : des balises explicites <npc_rename>, une correspondance approximative de sous-chaîne avant la création, et une recherche prenant en compte les alias.

Système de mémoire des PNJ : Chaque PNJ a une mémoire pondérée par l'importance calculée comme Score = 0,40 × Récence + 0,35 × Importance + 0,25 × Pertinence. Le Directeur génère des "réflexions" (comment un PNJ se sent) parallèlement aux observations factuelles. La mémoire reste limitée à 25 entrées par PNJ avec une consolidation intelligente.

Pile technique : Python 3.11+, NiceGUI, SDK Anthropic, EdgeTTS/Chatterbox (synthèse vocale), Faster-Whisper (reconnaissance vocale). La base de code fait environ 6 800 lignes réparties sur 5 fichiers. Les fonctionnalités incluent plus de 20 langues de narration, entrée/sortie vocale, export PDF, mode adapté aux enfants et compatibilité Raspberry Pi.