오픈소스 솔로 RPG 엔진은 구문 분석, 내레이션, 지시를 위해 세 개의 클로드 인스턴스를 사용합니다.

아키텍처와 파이프라인

EdgeTales는 플레이어가 캐릭터 행동을 입력하고, 주사위 메커니즘이 배후에서 결과를 결정하며, Claude AI가 결과를 바탕으로 분위기 있는 문장을 작성하는 Python 기반 솔로 RPG 엔진입니다. 핵심 설계 원칙은 "AI가 서술하지만 결정하지는 않는다"입니다. 주사위가 성공 또는 실패를 결정하고, Claude는 결과를 이야기로 바꾸기만 합니다.

이 시스템은 플레이어 턴당 세 개의 Claude 인스턴스를 사용하는 트리플-AI 파이프라인을 사용합니다:

• Brain (Claude Haiku): 자유 텍스트 입력을 RPG 동작, 스탯, 대상 NPC, 위치/효과 수준과 같은 필드가 포함된 구조화된 JSON으로 파싱합니다. 약 300ms가 소요되고 약 $0.0002의 비용이 듭니다.
• Narrator (Claude Sonnet): 주사위 결과, NPC 컨텍스트, 스토리 아크가 포함된 구조화된 프롬프트를 받아 분위기 있는 문장을 작성합니다. 또한 파서가 게임 상태 업데이트를 위해 추출하는 숨겨진 메타데이터(<new_npcs>, <memory_updates>)를 포함합니다. 약 2초가 소요되고 약 $0.003의 비용이 듭니다.
• Director (Claude Haiku): 플레이어가 서술을 본 후 비동기적으로 실행됩니다. TV 쇼러너처럼 장면을 분석하여 NPC 행동 힌트, 플롯 스레드 추적, 장면 요약을 제공합니다. 특정 이벤트(실패한 주사위 굴림, 새로운 NPC, 3번째 장면마다)에서만 트리거되며 플레이어에게는 지연 시간이 없습니다.

턴당 총 비용은 약 $0.003–0.004로, 20장면 세션 비용은 약 6–8센트입니다. Director의 출력은 다음 Narrator 프롬프트의 <director_guidance> 태그에 들어가며, Director가 실패할 경우 우아하게 저하됩니다.

기술 구현 세부사항

프롬프트 엔지니어링 교훈:

• 구조화된 XML 컨텍스트 주입(<world>, <character>, <npc>, <story_arc>, <director_guidance>)이 Sonnet의 출력을 문장 지시보다 더 일관성 있게 만들었습니다.
• Haiku는 구조화된 파싱에 효과적입니다. Brain은 자유 형식의 다국어 입력에서 8개 이상의 필드가 포함된 유효한 JSON을 반환합니다.
• JSON 복구는 필수적입니다. 두 모델 모두 가끔 잘못된 JSON(독일어 텍스트에서 쉼표 누락, 이스케이프되지 않은 줄바꿈, 후행 쉼표)을 생성합니다. 유효한 JSON에 대해 오버헤드가 없는 try-first 접근 방식의 _repair_json() 함수가 이를 처리합니다.
• NPC 중복 제거는 세 가지 안전망을 사용합니다: 명시적인 <npc_rename> 태그, 생성 전 퍼지 부분 문자열 매칭, 별칭 인식 검색.

NPC 메모리 시스템: 각 NPC는 점수 = 0.40 × 최근성 + 0.35 × 중요도 + 0.25 × 관련성으로 계산된 중요도 가중 메모리를 가집니다. Director는 사실적 관찰과 함께 "반성"(NPC가 어떻게 느끼는지)을 생성합니다. 메모리는 NPC당 25개 항목으로 제한되며 지능적인 통합을 통해 유지됩니다.

기술 스택: Python 3.11+, NiceGUI, Anthropic SDK, EdgeTTS/Chatterbox (TTS), Faster-Whisper (STT). 코드베이스는 5개 파일에 걸쳐 약 6,800줄입니다. 기능으로는 20개 이상의 서술 언어, 음성 입출력, PDF 내보내기, 어린이 친화 모드, Raspberry Pi 호환성이 포함됩니다.