ONEDEV

Soul-of-Waifu

AI Chat UIsCLIPython

★ 1,313주당 +19조회 11

무엇인가

Soul of Waifu는 데스크톱에서 실행되는 AI 캐릭터 롤플레이 애플리케이션이다. 사용자가 한 번 정의한 캐릭터가 텍스트·음성 대화, 탁상 RPG 세션, 화면 위에서 동작하는 OS 에이전트 모드에 걸쳐 같은 인격과 기억을 유지한다. 클라우드 구독형 컴패니언 서비스와 채팅 로그 검색에 의존하는 벡터 RAG 앱이 차지하던 자리를 로컬 실행으로 대체한다. Python으로 작성되었고 기본 설정에서 대화 데이터는 외부로 전송되지 않는다.

어떻게 동작하나

Soul Memory는 백그라운드 에이전트가 Psychology Layer, Relationship Profile, Episodic Topic Archive, Personal Diary 네 개의 인지 파일을 실시간으로 다시 쓰는 구조다. Psychology Layer는 현재 기분과 내적 긴장, 숨은 동기를 추적하고, Relationship Profile은 사용자 습관과 약속, 신뢰 진행도를 기록한다. Episodic Topic Archive는 장소·사건·핵심 사실을 분류해 로컬 시맨틱 임베딩으로 질의와 매칭한다. 감정 감쇠, 응답과 과거 사실의 모순 탐지 후 덮어쓰기, 근사 중복 기억 병합, 원자적 저장이 적용된다. 동기화 깊이는 Full Sync, Soul Link, Mind Spark, Reflection Flow 네 단계로 나뉜다.

무엇과 다른가

Soul Stage는 캐릭터와 분리된 Game Master AI 계층이 WorldState를 유지하는 탁상 RPG 엔진이다. 게임 내 시각·날씨·위치·핵심 사실을 상태로 보관하고 결정론적 주사위 굴림과 스킬 체크를 처리한다. 파티가 직접 밝혀야 하는 숨은 Story Arc, 압박 시계가 붙은 Campaign Board, 관계 추적, 캠페인을 묶는 Scene Folder가 함께 동작한다. Soul Companion은 신경호르몬 시뮬레이션 위에서 화면 인식, 마우스·키보드 제어, 헤드리스 브라우저 탐색, 샌드박스 Python/PowerShell 실행, 파일 정리를 수행한다. 위험 동작은 25초 페일세이프 카운트다운이 붙은 Human-in-the-Loop 승인 배너를 통과해야 실행된다. Discord Gateway는 이미지·GIF 컴퓨터 비전과 발화자별 구분을 처리한다.

어떻게 쓰나

일반적인 벡터 RAG가 과거 로그를 유사도로 검색하는 데 그치는 반면, 여기서는 기억이 별도 인지 파일로 재작성되어 응답 생성에 주입된다. 웹 검색·클립보드·앱 제어 같은 도구 호출이 컴패니언 모드가 아닌 일반 텍스트·음성 대화에서도 동작한다. Releases 페이지에서 배포본을 받아 실행한 뒤 캐릭터를 생성하거나 가져오고, 하드웨어 자원에 맞는 메모리 동기화 모드를 고른다. 외부 MCP 서버를 연결하거나 Python 플러그인을 직접 작성해 컴패니언 기능을 확장한다.

전제와 한계

로컬 LLM 구동에는 VRAM과 RAM 여유가 필요하고, 그 용량에 따라 선택 가능한 동기화 모드가 제한된다. 저사양 하드웨어나 무거운 추론이 필요할 때만 OpenAI·Claude·Gemini 같은 클라우드 제공자를 선택적 플러그인으로 등록한다. 브라우저와 웹 도구는 작업이 요구할 때 인터넷에 접속한다. 승인 배너를 통과하지 않은 위험 동작은 실행되지 않는다.

관련 논문 5

유사 도구