# yakami129/virtualwife

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/yakami129-virtualwife).**

2,786 stars · 437 forks · Python · mit

## Links

- GitHub: https://github.com/yakami129/VirtualWife
- awesome-repositories: https://awesome-repositories.com/repository/yakami129-virtualwife.md

## Topics

`chatgpt` `docker` `gpt` `nodejs` `ollama` `openai` `reatctjs` `virtual` `virtualwife` `webui`

## Description

VirtualWife is a framework for creating interactive 3D digital companions powered by large language models. It integrates a browser-based rendering engine that synchronizes 3D model animations and facial expressions with AI-generated dialogue in real time, supported by a voice interaction system that converts text into synthesized speech.

The system features a persona manager for defining role-play prompts, visual identities, and long-term conversational memory. It also includes a bridge for live streaming integration, allowing an AI avatar to interact with live audiences by monitoring comments on external video platforms.

The platform supports connectivity to both external language model providers and private local deployments. Core capabilities include the mapping of text to emotional gestures, the management of historical interaction data for continuity, and the incremental streaming of responses to reduce latency.

The application is provided as a containerized environment using Docker to ensure consistent installation and execution across different operating systems.

## Tags

### Artificial Intelligence & ML

- [AI Companion Simulations](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-companion-simulations.md) — Creates interactive 3D digital companions that simulate romantic mentors and psychological counselors. ([source](https://github.com/yakami129/VirtualWife#readme))
- [Persistent AI Companions](https://awesome-repositories.com/f/artificial-intelligence-ml/persistent-ai-companions.md) — Creates interactive 3D digital humans with custom personalities and persistent memory to provide emotional companionship.
- [Long-term Memory Stores](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/memory-management-systems/long-term-memory-stores.md) — Implements persistent storage mechanisms to retain user context and interaction history across multiple sessions. ([source](https://github.com/yakami129/VirtualWife/blob/main/FAQ.md))
- [Hybrid Short-and-Long Term Memory](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/memory-management-systems/long-term-memory-stores/hybrid-short-and-long-term-memory.md) — Maintains conversational continuity by integrating immediate session context with persistent long-term user memory. ([source](https://github.com/yakami129/VirtualWife#readme))
- [Character Dialogue Generation](https://awesome-repositories.com/f/artificial-intelligence-ml/character-dialogue-generation.md) — Integrates external language models with custom personas to generate character-driven roleplay dialogue.
- [Conversational Voice AI](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-voice-ai.md) — Enables hands-free interaction by recognizing spoken input and responding with synthesized speech. ([source](https://github.com/yakami129/VirtualWife#readme))
- [AI Companion Customizers](https://awesome-repositories.com/f/artificial-intelligence-ml/custom-ai-models/ai-companion-customizers.md) — Allows the creation and assignment of custom prompts to define the character behavior and role of the companion. ([source](https://github.com/yakami129/VirtualWife/blob/main/FAQ.md))
- [Digital Companion Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/desktop-ai-clients/ai-desktop-companions/digital-companion-frameworks.md) — Provides a complete framework for creating interactive 3D digital companions with AI-driven emotional responses.
- [Language Model Connectivity](https://awesome-repositories.com/f/artificial-intelligence-ml/language-model-connectivity.md) — Enables connectivity to both third-party cloud LLM providers and private local model deployments. ([source](https://github.com/yakami129/VirtualWife#readme))
- [Emotionally-Aware Response Generation](https://awesome-repositories.com/f/artificial-intelligence-ml/language-model-response-generators/response-generation-configurations/conversational-response-generation/emotionally-aware-response-generation.md) — Generates text replies paired with specific character expressions to convey nuanced moods. ([source](https://github.com/yakami129/VirtualWife/tree/main/domain-chatvrm))
- [LLM Provider Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-provider-integrations.md) — Integrates with both external LLM providers and local private deployments via a unified interface.
- [Companion Persona Customizers](https://awesome-repositories.com/f/artificial-intelligence-ml/persistent-ai-companions/companion-persona-customizers.md) — Provides tools for defining a digital companion's appearance, voice, and personality through prompts and 3D models. ([source](https://github.com/yakami129/VirtualWife/blob/main/README.md))
- [Persona Management Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/persona-management-systems.md) — Manages AI identities by defining role-play prompts, visual identities, and long-term conversational memory.
- [Voice Interaction Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/voice-interaction-systems.md) — Implements a voice interaction system that converts AI-generated text into synthesized speech using selectable voice packs.
- [Relationship Mentorship Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-support-automation/educational-mentorship/relationship-mentorship-systems.md) — Guides and supports users on romantic relationships through specialized AI-driven interactions. ([source](https://github.com/yakami129/VirtualWife/blob/main/package.json))
- [LLM Response Streaming](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-response-streaming.md) — Streams generated text and audio incrementally to the client to reduce perceived latency.
- [Hybrid Model Connectivity](https://awesome-repositories.com/f/artificial-intelligence-ml/local-model-integrations/hybrid-model-connectivity.md) — Supports integration with locally hosted language models to ensure data privacy during text generation. ([source](https://github.com/yakami129/VirtualWife/blob/main/FAQ.md))

### Part of an Awesome List

- [Facial Animation Models](https://awesome-repositories.com/f/awesome-lists/ai/facial-animation-models.md) — Provides a framework for synchronizing 3D avatar facial animations with generated AI speech. ([source](https://github.com/yakami129/VirtualWife#readme))
- [Large Language Model Deployments](https://awesome-repositories.com/f/awesome-lists/ai/local-model-deployment/large-language-model-deployments.md) — Supports the deployment of private language models on local hardware via Docker to ensure data privacy.

### Data & Databases

- [Conversation Memory Retrieval](https://awesome-repositories.com/f/data-databases/indexing-and-search/recall-optimization/conversation-memory-retrieval.md) — Stores and retrieves historical interaction data to maintain long-term conversational continuity.

### Graphics & Multimedia

- [3D Character Rendering Engines](https://awesome-repositories.com/f/graphics-multimedia/3d-character-rendering-engines.md) — Implements a browser-based rendering engine to display 3D models synchronized with AI dialogue. ([source](https://github.com/yakami129/VirtualWife/tree/main/domain-chatvrm))
- [3D Rendering Engines](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/scene-management-systems/3d-rendering-engines.md) — Provides a browser-based 3D rendering engine that calculates and displays character animations synchronized with AI speech.
- [Browser-Based 3D Visualizations](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/scene-management-systems/3d-rendering-engines/browser-based-3d-visualizations.md) — Displays and animates 3D character models directly within the web browser.
- [Conversational Animation Middleware](https://awesome-repositories.com/f/graphics-multimedia/media-production-suites/animation-tools/programmatic-animation-apis/animation-timing-utilities/conversational-animation-middleware.md) — Uses middleware to trigger specific facial expressions and body gestures based on the emotional content of AI text. ([source](https://github.com/yakami129/VirtualWife/blob/main/README.md))
- [Text-to-Animation Mappings](https://awesome-repositories.com/f/graphics-multimedia/text-to-animation-mappings.md) — Triggers specific 3D facial expressions and body gestures by analyzing the emotional content of generated text.
- [AI Avatar Streaming Bridges](https://awesome-repositories.com/f/graphics-multimedia/ai-avatar-streaming-bridges.md) — Routes synchronized audio and visual output to external streaming services for live audience interaction.
- [Live Broadcast Integrations](https://awesome-repositories.com/f/graphics-multimedia/live-broadcast-integrations.md) — Connects a digital entity to external streaming platforms for real-time interaction with a live audience. ([source](https://github.com/yakami129/VirtualWife/blob/main/README.md))
- [Psychological Support Interfaces](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/audio-processing-systems/audio-processing/text-to-speech-engines/emotional-tts-engines/psychological-support-interfaces.md) — Acts as a psychological counselor to meet the emotional and mental well-being needs of the user. ([source](https://github.com/yakami129/VirtualWife/blob/main/package.json))
- [Live Video Broadcasting](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/broadcasting-streaming/live-video-broadcasting.md) — Streams synchronized audio and visual avatar output directly to multiple video platforms for live broadcasting. ([source](https://github.com/yakami129/VirtualWife#readme))

### Security & Cryptography

- [Persona Prompt Mapping](https://awesome-repositories.com/f/security-cryptography/identity-access-management/access-control/identity-role-management/assistant-role-definitions/role-translation/persona-prompt-mapping.md) — Defines character behavior and personality by mapping specific system prompts to the language model.

### User Interface & Experience

- [Conversational Avatar Animators](https://awesome-repositories.com/f/user-interface-experience/keyboard-input-visualizers/input-reactive-character-animators/conversational-avatar-animators.md) — Synchronizes 3D avatar facial expressions and body gestures with AI-generated dialogue in real time.
- [Character Appearance and Persona Customizers](https://awesome-repositories.com/f/user-interface-experience/terminal-user-interfaces/visual-styling-presentation/interface-appearance-customization/component-appearance-customizers/application-appearance-customizers/windows-appearance-customizers/character-appearance-and-persona-customizers.md) — Defines role settings and imports 3D models to fully customize the appearance and personality of the virtual human. ([source](https://github.com/yakami129/VirtualWife#readme))
- [Avatar Appearance Configurators](https://awesome-repositories.com/f/user-interface-experience/avatars/avatar-appearance-configurators.md) — Allows users to upload and apply custom 3D models to customize the digital companion's visual identity. ([source](https://github.com/yakami129/VirtualWife/blob/main/FAQ.md))
- [Live Stream Chat Interactions](https://awesome-repositories.com/f/user-interface-experience/live-stream-dashboards/live-stream-chat-interactions.md) — Connects AI avatars to streaming platforms to monitor live comments and respond to audiences in real time.

### DevOps & Infrastructure

- [Docker Container Deployments](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments.md) — Packages the entire application and its dependencies into Docker images for consistent cross-platform execution. ([source](https://github.com/yakami129/VirtualWife/blob/main/README.md))
- [Application Containerizers](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/application-containerizers.md) — Offers a containerized environment that bundles the AI application and its dependencies for easy deployment.