Skip to content

jofizcd/Soul-of-Waifu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logotype


🌟 Don't miss the opportunity to breathe the soul into your characters along with Soul of Waifu 🌟
Experience the magic of conversing with AI-powered characters, complete with lifelike emotions, beautiful avatars, long-term memory, and a captivating voice.


YouTube Telegram Discord GitHub


Stars Forks Issues Discord Downloads

📚 Documentation • 🪙 Boosty • 🌐 Site


Soul of Waifu lets you bring your favorite characters to life using AI technology. Chat with them, interact via Speech-To-Text and Text-To-Speech technologies, view them as avatar images or fully animated Live2D or VRM 3D models - all directly within the app! For even deeper immersion into AI-powered roleplaying, you can use lorebooks, multiple custom user personas, write your own system prompts, create character cards in V2 specification as PNG images, and much, much more. And all of this is already waiting for you in Soul of Waifu!

Preview

⭐️ If you enjoyed the project, please give it a star! If you encounter any issues or have ideas for improving the program, feel free to share them with me on my Discord server or directly on GitHub. I look forward to hearing from you and thank you for using program!

Why do you need to choose Soul of Waifu?

🌞 Convenience and Comfort

Soul of Waifu offers a beautiful, intuitive desktop interface with a clean sidebar navigation and responsive design. Everything is in one place: your characters, models, settings, and tools. Whether you're creating a new character or managing your local LLMs, the process is smooth, organized, and user-friendly - no need to juggle multiple applications or complex setups.

Character List

✨ The Magic of Roleplay

Immerse yourself in AI-powered roleplaying with characters that feel alive. Soul of Waifu brings together chat, voice, avatars, high-quality memory, and emotion in a single, seamless experience. Start a conversation, call your character, hear their voice, see their emotions change in real-time - all without leaving the app.

Megumin Chat

🎭 Deep Character Creation

Create rich, dynamic characters with full control over their personality, backstory, and behavior. Import or export character cards in v2 spec (PNG), set custom greetings, define world lore, and fine-tune their responses. You can even assign specific personas to yourself, shaping how the AI perceives and interacts with you.

Character Editor

☁️ Support for Multiple AI Services

Soul of Waifu gives you the freedom to connect to a wide range of AI providers. Seamlessly switch between different backends depending on your needs, privacy preferences, and performance requirements. There are several provider to choose from: Character AI, Mistral AI, Open AI and OpenAI-compatible APIs, OpenRouter. This flexibility ensures you're never locked into a single provider. You can experiment with different models, compare responses, and find the perfect fit for each character.

Cloud Services

💾 Download and Run Local LLMs Directly in the App

No more manual model hunting or complex setups. Soul of Waifu integrates with Hugging Face, letting you search, preview, and download local language models (GGUF format) directly within the app. Powered by Llama CPP, it supports GPU acceleration (CUDA/Vulkan), memory locking (MLock), and Flash Attention - all configurable with a few clicks.

Models Hub

🔮 Voice & Avatars

Make your characters truly come alive. Choose from images, Live2D or VRM 3D models that react with 28 different emotions based on the conversation. Use advanced Text-to-Speech engines like Kokoro 82M, ElevenLabs, XTTSv2, or Edge TTS with support for Russian, English, Japanese, and Chinese voices. You can also use RVC models to change your character's voice. Enable Speech-to-Text (Vosk, Whisper) to talk to your character in real-time with Soul of Waifu System module.

Megumin-Angry

📔 Lorebooks, System Prompts, User Personas & More

Go beyond basic prompts. Use Lorebooks to inject world knowledge via keyword triggers, write custom System Prompts with full control over context order, and manage multiple User Personas for different scenarios. Enable Smart Memory to keep context relevant and efficient — only the most important messages are included in the prompt.

System-Prompt

🎆 Soul of Waifu System

Take your interactions to the next level with the Soul of Waifu System - a powerful module that enables real-time, speech-to-speech communication with your AI character. Talk naturally using your microphone, hear your character respond instantly in their unique voice, enjoy fully immersive calls where the character’s Live2D/VRM avatar reacts with emotions and animations.

sow-system

🔑 Privacy First

Your conversations stay on your machine. When using local language models, no data leaves your computer. Even with API-based services, your interactions remain confidential. You’re in full control - no corporate surveillance, no data harvesting, no censorship. Your waifu and your rules.

Requirements

  • Windows OS
  • Installing Dependencies
  • API-keys:
    • From Character AI (For Character AI conversation method)
    • From Mistral AI (For Mistral AI conversation method)
    • From Open AI (For Open AI conversation method)
    • From OpenRouter (For OpenRouter conversation method)
    • From ElevenLabs (for ElevenLabs TTS)

Installation

1) Downloading the program

Go to the Releases section and download the archive from the latest version.

2) Extracting files

Extract the contents of the archive into any convenient folder.

3) Dependencies installation

Run the installer.bat file to install all the project dependencies.

4) Launching the program

Use start.bat or Soul of Waifu.exe to launch the program.

Documentation

Soul of Waifu is accompanied by very detailed documentation that explains all aspects of the program and some terms, even if this is the first time you have come into contact with language models. Here is the link.

Upcoming Roadmap

Version 2.3
  • Mobile application for interacting with a desktop client
  • The main focus is on the Soul of Waifu System module
  • Creating a service for searching, downloading, and posting character cards (Characters Gateway)
  • Game integration module (Minecraft)
  • Bug fixes
  • And your other requests

Stats


Feedback

The Soul of Waifu project is constantly evolving and expanding, with many exciting updates and features planned for the future!

How You Can Help

If you enjoy the program and want to help accelerate new releases, give the project a star ⭐. Your support helps spread the word and keeps the project growing!

Join the Community

Join our Discord community, where AI enthusiasts like you collaborate. You can share your experience, help with the development, share character cards, lorebooks, guides and help shape the future of Soul of Waifu.


Thank you for being part of this journey and using Soul of Waifu! Together, we're making AI interactions more immersive, personal, and magical.


Developer

Jofi

Trying to make life a bit more interesting...

YouTube Discord

Support Author

  • Donation Link - Donate in the name of neural networks!
  • Boosty - Ну ты знаешь, что делать. Про все бонусы узнаешь на сайте, спасибо тебе за поддержку.

License

This project is distributed under the GPL v3 License.

License: GPL v3