# jofizcd/Soul-of-Waifu

🌌 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.

Repository: https://github.com/jofizcd/Soul-of-Waifu
Canonical: https://ross.abutalabs.com/products/soul-of-waifu
Homepage: https://jofizcd.github.io/soul-of-waifu-site/
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: ai, ai-girlfriend, ai-waifu, character-ai, live2d, ai-companion, ai-roleplay, ai-vtuber, llamacpp, neurosama, vrm, soul-of-waifu, anime, chatbot, desktop-app, local-llm, roleplay, virtual-girlfriend, ai-rpg-engine, desktop-waifu
Last push: 2026-08-17T22:12:57+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 98, longevity 78
- inputs: {"age_days": 1096, "days_push": 16, "days_rel": 17, "gap_med": 16.0, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1263, forks 62 (observed 2026-08-28T04:04:10.326491+00:00)

## What it is
Soul of Waifu is an open-source desktop application for creating AI companion characters with Live2D/VRM avatars, voice chat, and persistent evolving memory. It supports local LLMs via llama.cpp and cloud providers, and includes a tabletop RPG adventure mode and a desktop agent with OS access.

## Use cases
- run an ai waifu companion on my desktop with live2d avatar
- chat with ai characters locally without sending data to the cloud
- give my character a persistent memory that evolves over time
- play tabletop rpg adventures with an ai game master
- create an ai vtuber with voice and animated avatar
- roleplay chat app with lorebooks and custom scenarios
- desktop ai companion that can use my os and tools

## When to choose
- you want a local-first, private AI companion with animated Live2D/VRM avatars
- you need persistent cross-mode memory shared between chat, RPG, and desktop agent modes
- you want an open-source alternative to character.ai with voice and desktop presence
- you prefer running models offline via llama.cpp or choosing among many LLM providers

## When to avoid
- you need a headless API or backend service for embedding chatbots in products
- you want a lightweight text-only chat UI without avatar/voice overhead
- you require production-grade multi-user or server deployment
- you need official support beyond Windows desktop

## Facets
- artifact type: application
- maturity: active
- function: chatbot, chat-interface, llm-inference, tts, speech-recognition, gui, agent-framework
- domain: artificial-intelligence, large-language-models, chatbots, desktop-applications, gaming-tools, entertainment
- platform: windows, python, cross-platform
- tags: ai-companion, live2d, vrm, vtuber, roleplay, local-llm, llamacpp, anime, virtual-girlfriend, desktop-pet, rpg-engine, character-ai, desktop

## Member repositories
- jofizcd/Soul-of-Waifu (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:10.326491+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:04:08.561161+00:00, confidence not recorded.
  - readme: https://github.com/jofizcd/Soul-of-Waifu (fetched 2026-08-28T04:04:10.326491+00:00, sha 25cffc8443d1)
  - homepage: https://jofizcd.github.io/soul-of-waifu-site/ (fetched 2026-08-29T12:16:34.032336+00:00, sha 709ea5f18ece)
- Data as of 2026-08-30T08:39:29.467469+00:00.