# yakami129/VirtualWife

VirtualWife是一个虚拟数字人项目，支持B站直播，支持openai、ollama

Repository: https://github.com/yakami129/VirtualWife
Canonical: https://ross.abutalabs.com/products/virtualwife
Language: Python
License: MIT
License Family: permissive
Topics: chatgpt, virtual, virtualwife, docker, nodejs, reatctjs, webui, gpt, openai, ollama
Last push: 2024-10-27T07:09:17+00:00

## Health v2 (maintenance only)
Score: 20/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 85
- inputs: {"age_days": 1199, "days_push": 675, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2889, forks 443 (observed 2026-08-28T04:07:28.296073+00:00)

## What it is
VirtualWife is a self-hosted virtual digital human (AI companion) application that combines VRM 3D character models with LLM-powered conversation, voice synthesis, memory, and emotion features. It supports one-click Docker deployment, streaming responses, OpenAI/Ollama model backends, and livestreaming on Bilibili.

## Use cases
- run an AI companion virtual character with a 3D VRM avatar
- host a virtual YouTuber that livestreams on Bilibili with AI chat
- chat with a customizable AI girlfriend/persona using OpenAI or local Ollama models
- deploy a self-hosted voice chatbot with long-term memory via Docker
- give a virtual character text-driven facial expressions and body motions
- switch between Edge TTS and Bert-VITS2 for Chinese voice conversations

## When to choose
- you want a Docker-deployable virtual AI companion with a 3D avatar and voice
- you need Bilibili livestreaming driven by an LLM chatbot
- you want to swap between OpenAI and private Ollama models
- you want customizable VRM character models with emotion and motion control

## When to avoid
- you need a production-grade, stable virtual human platform for business use
- you want a lightweight CLI or library to embed rather than a full web application
- you need polished English-language support or extensive documentation
- you require guaranteed long-term maintenance, as the project is still in incubation

## Facets
- artifact type: application
- maturity: experimental
- function: chatbot, chat-interface, tts, llm-inference, agent-framework, rag, streaming, web-framework
- domain: artificial-intelligence, large-language-models, chatbots, self-hosted, entertainment, gaming-tools
- platform: windows, self-hosted, python
- tags: virtual-digital-human, vrm-models, bilibili-live, vtuber, ollama, openai, long-term-memory, voice-chat, docker-compose, companion-ai, natural-language-processing, docker, linux, macos, web-server, nodejs

## Member repositories
- yakami129/VirtualWife (main) score 20

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:28.296073+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-30T07:35:21.768052+00:00, confidence not recorded.
  - readme: https://github.com/yakami129/VirtualWife (fetched 2026-08-28T04:07:28.296073+00:00, sha 6364a11e8615)
- Data as of 2026-08-30T08:39:29.467469+00:00.