Soul of Waifu Soul of Waifu
Concept Features Screenshots History Download
sow-os:~$ boot --soul-core --v2.4

Breathe soul into your characters

Soul of Waifu is an open-source narrative AI engine. Create characters, run roleplay, use local and cloud models. No complexity — just immersion.

28 emotions
10 LLM providers
v2.4 version
Soul of Waifu 2.4
scroll
Architecture

One Soul. Three Dimensions.

Your companion's consciousness is unified. Watch them transition seamlessly across three distinct dimensions of existence, powered by a single, evolving cognitive memory core.

Soul Memory · Unified Engine Core Active
Soul Memory core engine
Unified Cognitive Core

Soul Memory — The Thread of Existence

Every character in Soul of Waifu possesses a single, unified digital brain. Whether you are chatting over voice, embarking on an RPG quest, or working with your companion on the desktop, they share the exact same memories, relationship states, and personal reflections. Their soul is not fragmented — it evolves continuously across all environments.

  • Subjective Diary: Deep first-person journal entries reflecting on your interactions across all modes
  • Persistent Relationship: Trust, affection, and behavioral traits adapt globally and persist seamlessly
  • Memory Self-Healing: A background agent constantly resolves factual and logical contradictions
  • Cognitive Profiles: Four distinct modes of memory depth to optimize your system resources
4memory layers
diary entries
4cognitive profiles

The Three Dimensions of Interaction

Your companion seamlessly morphs across three states depending on your needs.

I Chat
II Adventure
III Reality
Soul of Waifu · Chat Live
Soul of Waifu chat interface
I Pure thought

Text & Voice Chat

Text and voice chat with no artificial filters or restrictions. You have complete control over your roleplay experience — from interactive lorebooks to a flexible system of custom state variables. Create any scenario, assign a voice and visual avatar to your hero, and start your journey all within a single app.

  • Total creative freedom: interactive lorebooks, flexible editors, state variables, and avatars
  • Natural dialogue: built-in voice engines with real-time speech streaming
  • Complete flexibility: run models 100% locally or connect to powerful cloud APIs
6TTS engines
3variations of avatars
0censorship
Soul Stage · RPG Running
Soul Stage
II Great adventure

Soul Stage — RPG Immersion

Turn a regular chat into a full text RPG. A party of heroes journeys under a virtual Game Master — with inventory, dynamic NPCs, and random events.

  • AI Game Master and story triggers
  • Inventory and stats system
  • Dynamic NPCs and random events
party heroes
NPCs and locations
genres of plot
Desktop · Soul Companion 23:47
Soul of Waifu System mode
III Into reality

Soul Companion — Your Desktop Assistant

Your character steps out of the chat and onto your desktop as a Live2D or VRM avatar. Powered by neurohormones, they experience tiredness, get bored, share thoughts, and proactively start conversations, commenting on your activity and helping you with daily PC tasks.

  • Environmental awareness: visual screen recognition and smart clipboard reading
  • Proactive AI: thoughtful commentary on your activity and independent thoughts
  • Tool Calling support: use the built-in tools or connect to an MCP server
24/7always active
MCPprotocol support
6built-in tools
MCP Protocol Screen Aware Neurohormones Proactive AI

Configure your character once — their unified soul will accompany you all the way from a deep text line to immersive RPG campaigns and desktop co-presence.

Download Soul of Waifu
Features

Everything you need for immersion

Powerful engine under the hood, intuitive interface on top

Ergonomics & Focus

The interface is designed to remove distractions, keeping the spotlight entirely on your companion. With a streamlined sidebar, organized tabs, and polished animations, navigating the platform is natural and effortless right from the start.

  • Clean and ergonomic visual style
  • Sidebar and clean tab-based layout
  • Interactive chat with smooth, flowing text animations
  • Laconic notification toasts that never interrupt your immersion
Interface

Freedom of AI Choice

Run open-source models completely offline or connect to leading cloud APIs. With the built-in server, setting up local GGUF models is seamless — simply download your preferred model directly from the interface.

  • Top-tier cloud models: Claude, DeepSeek, GPT-4o, Gemini, Grok, and Qwen
  • Built-in Llama CPP Server with full hardware acceleration
  • Visual download manager for local models with instant cancellation
  • Native acceleration for CUDA, Vulkan, Intel SYCL, and AMD HIP
Interface

Feature-Rich Chat

A complete space for deep conversation: manage chat histories, organize your library into folders, make live audio calls, and set custom backgrounds. You can even send empty messages to prompt your companion to continue their train of thought.

  • Organize your character library easily using custom folders
  • Seamless history import/export and contextual author notes
  • Local web client to chat from your smartphone within your home network
  • Custom chat backdrops and a dedicated text-generation stop button
Interface

Voice & Visual Presence

Characters speak naturally using advanced speech engines with life-like inflections. Voice playback starts instantly, sentence-by-sentence, eliminating awkward wait times. The platform supports dynamic Live2D (with motion animations), 3D VRM avatars, custom images, and GIFs.

  • Instant, sentence-by-sentence voice streaming with zero delays
  • Multiple text-to-speech options, voice cloning, and RVC parameters
  • Interactive Live2D and VRM avatars with motion support and LipSync
  • Real-time text analysis recognizing 28 distinct emotional states
Interface

Professional Narrative

Fine-tune story arcs and character depth using layered lorebooks, custom state variables, and the interactive Soul Stage mode. The virtual Game Master takes care of all the world-building, tracking, and campaign progression for your adventure.

  • Link multiple lorebooks simultaneously with semantic story triggers
  • Soul Stage RPG system with a unified World State and inventory
  • Custom state variables visualized via an adaptive horizontal HUD
  • Industry-standard V2 Spec compatibility (PNG/JSON card import)
Interface

Advanced Configuration

A complete control center for your AI engine. Fine-tune advanced text samplers, local model quantization parameters, MoE layers, context window sizing, and enable Thinking Mode for reasoning networks.

  • Advanced samplers: Min-P, XTC, DRY, and dynamic temperature
  • Low-level LLM tuning: and custom launch settings
  • A wide variety of Soul of Waifu feature expansion modules
  • Total appearance customization: unique themes and message bubbles
Interface
Interface

Look inside

Click on a screenshot to enlarge

Character list
Character List
01
Character List Interactive cards with quick access to settings
Chat
Chat
02
Chat Smooth text animation and typing indicator
Character editor
Character Editor
03
Character Editor Detailed personality and scenario setup
Lorebook
Lorebook
04
Lorebook Game Master and story event triggers
Models Hub
Models Hub
05
Models Hub Download and manage GGUF models
SoW System
SoW System
06
SoW System Talk to the character via microphone
Soul Memory
Soul Memory
07
Soul Memory Cognitive memory layers & personal diary
Soul Stage
Soul Stage
08
Soul Stage Interactive RPG-session under virtual GM control
Soul Companion
Soul Companion
09
Soul Companion Desktop companion widget with neurohormones & MCP
History

Development journey

From a console tool to a multi-dimensional character platform

742 GitHub stars
~14000 downloads
3 years in development
1600 community members
2023
Console version 2023
September 2023

Console program

The beginning — a simple console utility for AI interaction with basic text input and logic. The first commit that would grow into Soul of Waifu.

v1
v1.0 v1.0
2024 — v1.0

First graphical interface

Move to GUI. Worked only with Character AI — but it was a big step forward.

v2.0
v2.0 v2.0
March–April 2025 — v2.0 / v2.1

Built from scratch

A full platform rewrite (v2.0): new GUI, local GGUF models, Mistral AI integration, and XTTS voice synthesis. A month later, v2.1 added OpenAI and OpenRouter support plus Edge TTS with RVC voice cloning.

v2.2
v2.2 v2.2
August 30, 2025 — v2.2

Visual Evolution

A complete interface redesign — the “Soul Renaissance” release. Added VRM avatar support, GPU acceleration (CUDA/Vulkan), the Models Hub, lorebooks, Smart Memory, and ambient sounds.

v2.3
v2.3 v2.3
March 30, 2026 — v2.3

Era of living companions

The “Soul Resonance” release: real-time voice with interruption and LipSync, the launch of Desktop Companion mode, a new RPG lorebook engine, the signature Liquid Glass interface, local-model improvements, and automatic chat summarization.

v2.4.0
v2.4.0 v2.4.0
2026 — v2.4.0 Current

Four Dimensions

The release that delivers all four dimensions at once: the Soul Memory long-term memory module, the Soul Stage RPG mode with a virtual Game Master, and a fully reworked desktop companion — now called Soul Companion — with MCP tool support. Plus a Discord gateway, local web client, image generation, and a full interface redesign.

??
Shaping the Future

The next chapter is yours to write

Soul of Waifu is driven entirely by its community. What comes next depends on your ideas, feedback, and active involvement. Join our official Discord server to discuss development, suggest new features, and directly influence the evolution of the project.

Join our Discord
Download

Ready to dive in?

Download Soul of Waifu and start creating your characters right now. Free and open source.

v2.4.0 ~7 GB Changelog

System requirements

  • Windows 10 / 11 (64-bit)
  • 16 GB RAM (32 GB recommended)
  • NVIDIA / AMD GPU (optional)
  • ~7 GB free space