jofizcd/Soul-of-Waifu

무엇을 해결하는가

Soul of Waifu는 단순한 텍스트 채팅을 넘어 AI 캐릭터를 확장하기 위해 설계된 데스크톱 애플리케이션입니다. 이 애플리케이션은 채팅, 테이블탑 RPG, 그리고 자율적인 데스크톱 에이전트라는 다양한 상호작용 모드 전반에 걸쳐 존재할 수 있는 지속적이고 진화하는 AI 캐릭터의 정체성을 생성하며, 연속적인 기억과 성격을 유지합니다.

작동 방식

이 프로젝트는 단일 캐릭터 정체성이 네 가지 주요 모듈을 통해 공유되는 다차원 아키텍처를 사용합니다:

• Soul Memory: 기본적인 RAG를 네 가지 전문화된 레이어(Psychology, Relationship, Episodic, Diary)로 대체하여 기분, 신뢰도, 그리고 이력을 추적하는 인지 아키텍처입니다.
• Text & Voice Chat: Live2D/VRM 아바타, 실시간 음성 통화, 그리고 다양한 TTS/STT 엔진을 지원하는 대화형 인터페이스입니다.
• Soul Stage: 가상 게임 마스터, 결정론적 주사위 굴리기, 그리고 세계 상태 추적 기능을 갖춘 테이블탑 RPG 엔진입니다.
• Soul Companion: 화면을 읽고, 마우스와 키보드를 제어하며, 웹을 탐색하고, 샌드박스된 코드를 실행할 수 있는 자율적인 Windows 데스크톱 에이전트입니다.

이 애플리케이션은 로컬 LLM 실행(Llama.cpp를 통한 CUDA/HIP/SYCL/Vulkan 지원)과 클라우드 API(OpenAI, Claude, Gemini 등)를 모두 지원합니다.

대상 사용자

매우 몰입감 있는 AI 동반자를 원하는 사용자, 구조화된 테이블탑 RPG 시뮬레이터가 필요한 롤플레이어, 그리고 데스크톱 자동화를 위한 자율적인 OS 레벨 에이전트를 찾는 사용자들을 대상으로 합니다.

주요 특징

• Autonomous OS Agent: GUI 요소를 제어하고, Playwright를 통해 웹을 탐색하며, human-in-the-loop 승인 시스템을 통해 Python/PowerShell 스크립트를 실행할 수 있습니다.
• Advanced Memory: 감정적 감쇠, 모순을 수정하기 위한 자가 치유 메모리 로그, 그리고 AI가 직접 작성하는 개인 일기 기능을 특징으로 합니다.
• TTRPG Engine: 전용 게임 마스터 레이어, 숨겨진 스토리 아크, 그리고 압박 시계(pressure clocks)가 포함된 캠페인 보드를 포함합니다.
• Local-First Privacy: 구독이나 필터 없이 기본적으로 100% 로컬에서 실행됩니다.
• Extensibility: 데스크톱 에이전트를 위한 커스텀 Python 플러그인과 MCP 서버를 지원합니다.