Soul-of-Waifu

给二次元角色注入灵魂，在桌面开启沉浸式 AI 陪伴与冒险

Soul of Waifu 是一款桌面端 AI 角色扮演与陪伴应用，旨在为二次元角色注入灵魂。它支持 Live2D 和 VRM 模型，让角色以生动形象出现在桌面上，并提供语音聊天与本地大语言模型（LLM）支持，保护隐私。核心能力包括沉浸式聊天、RPG 冒险模式，以及角色成长系统，用户可与角色共同经历故事、培养关系。项目基于 Python 构建，整合了多种 AI 技术，适合喜欢二次元文化、寻求个性化 AI 陪伴或角色扮演体验的用户。它解决了通用聊天机器人缺乏人格化、形象化的问题，通过可定制角色和桌面交互，营造出更真实的陪伴感。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1340

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队jofizcd

所属国家

官网地址https://jofizcd.github.io/soul-of-waifu-site

GitHubhttps://github.com/jofizcd/Soul-of-Waifu

定价模式free

价格说明开源桌面应用，GPL-3.0许可，本地部署，完全免费。

访问状态

是否开源是

开源协议GPL-3.0

主要语言Python

技术栈/模型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

GitHub 星标★ 1340

30天Star增速

HF 下载量

上线时间2023-09-02 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

Windows 桌面环境（安装脚本为 .bat 批处理）
7-Zip 或 WinRAR 等解压工具
解压路径不含空格与西里尔字符，例如 C:AISoul-Of-Waifu
云端方案需自备 OpenRouter 或 OpenAI API Key；本地方案需可用的 GPU 环境

安装与启动步骤

1下载发布包

打开 GitHub Releases 页面，下载最新版本压缩包（当前为 Soul-of-Waifu-v2.4.7.rar）。
2解压到英文路径

用 7-Zip 或 WinRAR 解压到不含空格或西里尔字符的目录，例如 C:AISoul-Of-Waifu。
3运行安装脚本

双击 installer.bat 完成安装，切勿以管理员身份运行，否则路径会出错。
```
installer.bat
```
4启动应用

双击 start.bat 启动程序，等待主窗口出现。
```
start.bat
```
5配置云端 AI

无 GPU 时选方案 A：进入 Options -> Configuration 填入 OpenRouter 或 OpenAI API Key。
6或配置本地模型

有 GPU 时选方案 B：Models Hub 搜索 Gemma/Qwen 下载 Q4_K_M GGUF，在 Options -> LLM Settings 选后端并启动服务。
7导入角色卡

在 Characters Gateway 导入角色，或把 .png / .json 角色卡直接拖入应用窗口。

关键配置

配置项	必填	说明	示例
`OpenRouter API Key`	否	方案 A 云端对话所需密钥，填入 Options -> Configuration。	`sk-or-v1-xxxxxxxx`
`OpenAI API Key`	否	也可用 OpenAI 官方密钥替代 OpenRouter。	`sk-xxxxxxxx`
`GPU 后端`	否	本地方案在 Options -> LLM Settings 选择 CUDA/HIP/SYCL/Vulkan。	`CUDA`
`Flash Attention`	否	本地模型推理加速开关，在 LLM Settings 中启用。	`启用`

如何确认成功

运行 start.bat 后应用主窗口正常出现，配置好 API Key 或本地模型服务后即可开始文本或语音对话。

常见问题

Q：运行 installer.bat 时报路径错误怎么办？

A：不要以管理员身份运行。管理员权限会把工作目录改为 C:WindowsSystem32，导致安装路径判断错误，普通双击即可。

Q：没有独立显卡能用吗？

A：可以。选择方案 A 云端 AI，在 Options -> Configuration 填入 OpenRouter 或 OpenAI API Key 即可，无需 GPU。

Q：本地模型该下载哪个文件？

A：在 Models Hub 搜索 Gemma 或 Qwen 等模型，下载 Q4_K_M 的 GGUF 量化版本，显存占用更低。

Q：怎么导入自己的角色？

A：从 Characters Gateway 导入，或直接把 .png / .json 角色卡文件拖拽到应用窗口内。

注意事项

安装目录不要含空格或西里尔字符，建议使用 C:AISoul-Of-Waifu 这类纯英文短路径。
请勿以管理员身份运行 installer.bat，否则会因工作目录切换而安装失败。
README 仅提供 Windows 的 .rar 发布包与 .bat 脚本安装方式，未给出源码编译或其他平台步骤。
安装完成后网页搜索、剪贴板访问、应用控制等工具在普通文本与语音聊天中即可使用。

核心亮点

支持 Live2D 和 VRM 模型，角色形象生动，可自定义外观
集成语音聊天，交互更自然，增强沉浸感
本地 LLM 支持，数据私密，无需联网也可使用

不足之处

项目仍处于成长阶段，功能稳定性与文档完善度待观察
依赖本地 LLM 时，对硬件配置有一定要求

适用场景

二次元爱好者想要与喜欢的角色进行日常聊天和互动
用户希望体验带有剧情和 RPG 元素的 AI 角色扮演游戏
注重隐私的用户希望在离线环境下使用 AI 陪伴功能

替代项目

SillyTavern、TavernAI、KoboldAI

项目介绍

Soul-of-Waifu 是数字人3D领域的开源项目，由 jofizcd 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,340）位列前 30%，在数字人3D分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,152 增加到 1,340，净增 188。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。开源桌面应用，GPL-3.0许可，本地部署，完全免费。

它主要面向的使用场景是：二次元爱好者想要与喜欢的角色进行日常聊天和互动。同类可对比的替代方案包括 SillyTavern、TavernAI、KoboldAI。

上一篇：ChatdollKit

下一篇：lobe-vidol