Soul-of-Waifu

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

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

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 84 🐛 待处理 15 👀 关注 47

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1451

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源桌面应用，GPL-3.0许可，本地部署，完全免费。

项目预览

项目数据

分类对话助手

开发团队jofizcd

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

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

定价模式🏷️完全免费

价格说明开源桌面应用，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 星标★ 1451

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

代码更新2026-08-28

仓库体积71.5 MB

本站数据更新2026-11-08

维护状态维护中

收录时间2026-08-09

浏览次数4

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1451

技术标签

ai ai-companion ai-vtuber ai-waifu anime

使用教程

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

环境要求

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

安装与启动步骤

1下载发布包

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

用 7-Zip 或 WinRAR 解压到不含空格或西里尔字符的目录，例如 C:\AI\Soul-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 中启用。	`启用`