{"data":{"slug":"jofizcd-soul-of-waifu","name":"Soul-of-Waifu","tagline":"A desktop roleplay and AI companion app with live avatars and voice chat.","github_url":"https://github.com/jofizcd/Soul-of-Waifu","owner":"jofizcd","repo":"Soul-of-Waifu","owner_avatar_url":"https://avatars.githubusercontent.com/u/103282270?v=4","primary_language":"Python","stars":1329,"forks":69,"topics":["ai","ai-companion","ai-girlfriend","ai-roleplay","ai-rpg-engine","ai-vtuber","ai-waifu","anime","character-ai","chatbot","desktop-app","desktop-waifu","live2d","llamacpp","local-llm","neurosama","roleplay","soul-of-waifu","virtual-girlfriend","vrm"],"archived":false,"github_pushed_at":"2026-08-28T10:51:57+00:00","maintenance_label":"Active","stars_delta_30d":154,"url":"https://www.graphcanon.com/tools/jofizcd-soul-of-waifu","markdown_url":"https://www.graphcanon.com/tools/jofizcd-soul-of-waifu.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/jofizcd-soul-of-waifu","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=jofizcd-soul-of-waifu","description":"🌌 Give a soul to your favorite characters. Soul of Waifu is a desktop roleplay & AI companion app featuring Live2D/VRM avatars, voice chat & local LLM. Evolve together across immersive chat, RPG adventures, and your desktop.","homepage_url":"https://jofizcd.github.io/soul-of-waifu-site/","license":"GPL-3.0","open_issues":10,"watchers":43,"ai_summary":"Soul of Waifu is an application that blends character animations and artificial intelligence to provide users with interactive companions for various activities such as chatting, RPG gaming on the desktop. The app features local LLM integration for conversational roles.","readme_excerpt":"## 📥 Installation\n\nNo Python knowledge, Node.js, or command-line experience required.\n\n```\n1. Download the latest release archive (currently Soul-of-Waifu-v2.4.7.rar) from Releases.\n2. Extract it with 7-Zip or WinRAR to a path without spaces or Cyrillic characters (e.g. C:\\AI\\Soul-Of-Waifu\\).\n3. Run installer.bat (Do NOT run as Administrator).\n4. Launch via start.bat.\n```\n\n> [!WARNING]\n> **Do not run `installer.bat` as Administrator!** Windows changes the working directory for Administrator processes to `C:\\Windows\\System32`, causing installation path errors. Use a standard double-click.\n\n---\n\n### System Requirements\n\n| | Minimum | Recommended |\n|---|---|---|\n| **OS** | Windows 10/11 (64-bit) | Windows 10/11 (64-bit) |\n| **RAM** | 8 GB | 16 GB+ |\n| **GPU** | Any (for Cloud APIs) | NVIDIA / AMD with 6+ GB VRAM (for local models) |\n| **Storage** | 10 GB free space | Fast NVMe SSD |\n\n---\n\n---\n\n## ⚡ Quick Start\n\n- **Option A — Cloud AI (No GPU Required):**\n  Go to **Options -> Configuration**, input your OpenRouter or OpenAI API key. Import a character card from the **Characters Gateway** or drag-and-drop a `.png` / `.json` file into the app window.\n- **Option B — Local AI:**\n  Navigate to **Models Hub**, search for a model (e.g. `Gemma` or `Qwen`), and download a `Q4_K_M` GGUF quantization. In **Options -> LLM Settings**, select your GPU backend (CUDA/HIP/SYCL/Vulkan), enable Flash Attention, and launch the server via Models Hub.\n\nOnce you're set up, web search, clipboard access, app control and other tools are available straight away in regular text and voice chats - no need to switch to Soul Companion mode to use them.\n \n📖 Read full documentation & guides: **[jofizcd.github.io/soul-of-waifu-site/docs](https://jofizcd.github.io/soul-of-waifu-site/docs/)**\n \n---","github_created_at":"2023-09-02T14:43:26+00:00","created_at":"2026-07-15T10:58:47.70718+00:00","updated_at":"2026-09-20T05:00:54.852968+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"speech-audio","name":"Speech & Audio","url":"https://www.graphcanon.com/categories/speech-audio","markdown_url":"https://www.graphcanon.com/categories/speech-audio.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/speech-audio"}],"tags":[{"slug":"ai-companion","name":"ai-companion"},{"slug":"character-ai","name":"character-ai"},{"slug":"live2d","name":"live2d"},{"slug":"local-llm","name":"local-llm"},{"slug":"roleplay","name":"roleplay"},{"slug":"voice-chat","name":"voice-chat"}],"trust":{"provenance":{"is_fork":false,"github_id":686364338,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T05:00:52.220Z","maintenance":{"label":"Active","score":82,"methodology":"github_public_v1","releases_90d":6,"days_since_push":22,"last_release_at":"2026-08-28T10:51:57Z","stars_delta_30d":154,"open_issues_delta_30d":-4},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-15T10:58:48.989Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-09-20T05:00:53.267Z"},"languages":{"value":["python"],"source":"github.language","observed_at":"2026-09-20T05:00:53.267Z"},"license_spdx":{"value":"GPL-3.0","source":"github.license","observed_at":"2026-09-20T05:00:53.267Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["When seeking an immersive AI companionship experience that integrates personalized Live2D or VRM avatar interactions specifically styled after anime characters","For users interested in conducting conversations through a locally managed language model, ensuring higher privacy compared to cloud-based solutions"],"when_not_to_use":["If you require robust multiplayer functionalities for online gaming roleplay as the app focuses on individual user experiences with AI companions","In scenarios where absolute minimum hardware resources are required, since Soul-of-Waifu may demand more processing power due to its live avatar and voice chat features"],"source":"enrich:decision_facts","observed_at":"2026-07-17T10:03:26.621Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"Soul-of-Waifu is a desktop roleplay and AI companion app with local LLM integration for interactive companionship featuring live avatars and voice chat capabilities."}]}}