Open-Source-Solo-RPG-Engine nutzt drei Claude-Instanzen für Parsing, Erzählung und Steuerung

Architektur und Pipeline

EdgeTales ist eine Python-basierte Solo-RPG-Engine, bei der Spieler Charakteraktionen eingeben, Würfelmechaniken die Ergebnisse im Hintergrund auflösen und die Claude-KI atmosphärische Prosa basierend auf den Ergebnissen schreibt. Das zentrale Designprinzip ist "KI erzählt, sie entscheidet nicht" – Würfel bestimmen Erfolg oder Misserfolg, während Claude nur Ergebnisse in Geschichte verwandelt.

Das System verwendet eine Triple-AI-Pipeline mit drei Claude-Instanzen pro Spielerzug:

• Brain (Claude Haiku): Parst Freitext-Eingaben in strukturiertes JSON mit Feldern wie RPG-Zug, Statistik, Ziel-NPC, Position/Effekt-Level. Dauert ~300ms und kostet ~$0,0002.
• Narrator (Claude Sonnet): Erhält strukturierte Prompts mit Würfelergebnissen, NPC-Kontext und Handlungsbogen, dann schreibt es atmosphärische Prosa. Betten auch versteckte Metadaten (<new_npcs>, <memory_updates>) ein, die der Parser für Spielzustandsaktualisierungen extrahiert. Dauert ~2s und kostet ~$0,003.
• Director (Claude Haiku): Läuft asynchron, nachdem der Spieler die Erzählung gesehen hat. Analysiert Szenen wie ein TV-Showrunner für NPC-Verhaltenshinweise, Plot-Strangverfolgung und Szenenzusammenfassungen. Wird nur bei bestimmten Ereignissen ausgelöst (fehlgeschlagene Würfe, neue NPCs, jede 3. Szene) mit null spielerseitiger Latenz.

Die Gesamtkosten pro Zug betragen ~$0,003–0,004, sodass eine 20-Szenen-Session ~6–8 Cent kostet. Die Ausgabe des Directors geht in <director_guidance>-Tags im nächsten Narrator-Prompt ein, mit sanftem Abbau, falls der Director versagt.

Technische Implementierungsdetails

Prompt-Engineering-Lektionen:

• Strukturierte XML-Kontextinjektion (<world>, <character>, <npc>, <story_arc>, <director_guidance>) machte Sonnets Ausgabe konsistenter als Prosa-Anweisungen.
• Haiku ist effektiv für strukturiertes Parsing – der Brain liefert gültiges JSON mit 8+ Feldern aus freiformatiger mehrsprachiger Eingabe.
• JSON-Reparatur ist essentiell. Beide Modelle produzieren gelegentlich fehlerhaftes JSON (fehlende Kommas in deutschem Text, nicht maskierte Zeilenumbrüche, nachgestellte Kommas). Eine _repair_json()-Funktion mit Try-First-Ansatz behandelt dies ohne Overhead für gültiges JSON.
• NPC-Deduplizierung verwendet drei Sicherheitsnetze: explizite <npc_rename>-Tags, Fuzzy-Substring-Matching vor Erstellung und alias-bewusste Suche.

NPC-Gedächtnissystem: Jeder NPC hat gewichtete Erinnerungen nach Wichtigkeit, berechnet als Score = 0,40 × Aktualität + 0,35 × Wichtigkeit + 0,25 × Relevanz. Der Director generiert "Reflexionen" (wie sich ein NPC fühlt) neben faktischen Beobachtungen. Das Gedächtnis bleibt auf 25 Einträge pro NPC begrenzt mit intelligenter Konsolidierung.

Technischer Stack: Python 3.11+, NiceGUI, Anthropic SDK, EdgeTTS/Chatterbox (TTS), Faster-Whisper (STT). Die Codebasis umfasst ~6.800 Zeilen über 5 Dateien. Funktionen umfassen 20+ Erzählsprachen, Sprach-E/A, PDF-Export, kinderfreundlichen Modus und Raspberry-Pi-Kompatibilität.