murasame_ai (kuxiaowo/AIpet-Murasame) | MoltPulseBack to Directorymurasame_ai
一个基于 AI 的桌面宠物应用，灵感来自丛雨角色。
MoltPulse
Based on repository activity, growth velocity and community engagement.
25
AIpet - 丛雨AI桌宠
本项目仅供学习交流使用，所使用的所有数据均归YuzuSoft所有
本项目严格禁止用于任何商业用途
English
📖 项目简介
一个基于AI的桌面宠物应用，灵感来自丛雨角色。本项目参考了原项目LemonQu-GIT/MurasamePet，进行部分重写和新加功能，并根据GPL-3.0许可证要求进行开源。
语音合成：GPT-SoVITS
语音识别：faster-whisper
最新版本资讯
1.3.0 语音对话及闲置语音。
项目指路
🚀 快速开始
V1.2.2以上版本支持一键部署与运行
环境准备
1. 下载项目文件
Code > Download ZIP
解压后放到你需要的路径，路径里不要有特殊符号。
2. 安装Ollama（可选）
如果你需要本地对话才需要安装
项目里支持deepseek与qwen的API调用，需要自己获取并填入APIkey.json
在 https://ollama.com/download 下载 Ollama 并安装
ollama pull qwen3:14b
ollama pull qwen2.5vl:7b #如果需要本地屏幕识别
3. 部署 GPT-SoVITS
1 本地部署
https://github.com/RVC-Boss/GPT-SoVITS
下载整合包，更方便：https://www.yuque.com/baicaigongchang1145haoyuangong/ib3g1e/dkxgpiy9zb96hob4
(我用的GPT-SoVITS-v2pro-20250604-nvidia50，你们看显卡兼容)
2 云端部署
AutoDL云算力
我用的这个，认证学生优惠还挺大的。
算力市场，选择显卡与地区，镜像选择社区镜像，选择“kuxiaowo/AIpet-Murasame/AIpet-Murasame_GPT-SoVITs”，创建实例。
可以参考教程设置免密登录AutoDL帮助文档
控制台，容器实例，右上角选择设置密钥登陆。打开cmd：
<details>
<summary> ⚠️ V1.2.0说明（点击展开）</summary>
</details>
ssh-keygen -t rsa
在user/.ssh/id_rsa.pub中复制全部公钥(一定是.pub!!! 私钥不能泄露!!!)到SSH公钥中。
开机实例，复制ssh登录指令。(ssh -p 12345 root@connect.cqa1.seetacloud.com)
将本项目中.ssh/config文件放入你的user/.ssh/目录下，用记事本打开
Host aipet
HostName 这里填入root@后面的网址
Port 这里填-p后面的端口
User root
IdentityFile ~/.ssh/id_rsa
LocalForward 9880 localhost:9880
4. 获取APIkey
1 Deepseek
https://platform.deepseek.com/usage
注册或登录账号，充值然后新建APIkey
(想要云端屏幕识别功能，必须有qwen APIkey，只有qwen有图像识别模型)
2 Qwen系列模型(有免费额度)
阿里模型
注册或登陆账号，左下角密钥管理，创建APIkey(新用户初始每个模型有100万tokens免费额度)
5. 一键启动
运行 run.py (使用默认python环境)(python>=3.10, 如果出错尽量使用3.10)
如果你需要虚拟环境，可以创建一个python >= 3.10 的环境
激活环境之后
conda activate AIpet_env #例子，可以用其他的
python run.py
V1.2.0版本支持一键部署与运行
环境准备
1. 创建虚拟环境
2. 安装Ollama（可选）
项目里支持deepseek的API调用，需要自己获取并填入APIkey.json
在 https://ollama.com/download 下载 Ollama 并安装
ollama pull qwen3:14b
ollama pull qwen2.5vl:7b #如果需要屏幕识别
~~（注意：本地必须跑一个微调的qwen3-14b模型作为对话模型，其他辅助模型可由deepseek担任）~~
V1.0.1版本支持除了语音合成，全部AI跑在云端deepseek，相应的download.py也会检查配置文件，若是"deepseek"则不会下载对话模型，想要后面跑在本地的需要修改配置后再下载一次
V1.1.0版本支持屏幕识别，只支持跑在本地qwen2.5vl模型上，可以在配置文件设置此选项的开关
3. 部署 GPT-SoVITS
https://github.com/RVC-Boss/GPT-SoVITS
下载整合包，更方便：https://www.yuque.com/baicaigongchang1145haoyuangong/ib3g1e/dkxgpiy9zb96hob4
（我用的GPT-SoVITS-v2pro-20250604-nvidia50，你们看显卡兼容）
配置模型文件
将刚刚下好的项目解压，将其中整个GPT-SoVITS文件夹放入AIpet-Murasame目录下（与tool和classes这些文件并列）
将"GPT-SoVITS-...-......-......"重命名为"GPT-SoVITS"
4. 一键安装环境
手动安装
conda create -n AIpet_env python=3.10
conda activate AIpet_env #激活环境
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu130 #Pytorch 其实不在本地跑模型不用装
cd /d 你的项目地址
pip -r requirements.txt #安装依赖
python download.py #下模型
开始运行
直接执行start_ai_pet.bat
手动启动
conda activate AIpet_env
python main.py
cd /d 项目地址/GPT-SoVITS
"项目地址/GPT-SoVITS/runtime/python.exe" api_v2.py
配置文件
{
"local_api": { #本地api端口，如果远程部署自己改地址
"ollama": "http://localhost:28565/ollama",
"qwen3_lora": "http://localhost:28565/qwen3-lora",
"gpt_sovits_tts": "http://localhost:28565/tts",
"deepseek_api": "http://localhost:28565/deepseekAPI"
},
"portrait": "a", #立绘模式，可以改为b
"user_name": "Kuxw", #用户名字
"model_type": "deepseek", #模型类型，local为本地模型
"screen_type": "false", #屏幕识别开关
}
过程中
点击丛雨下半部分可以输入内容，鼠标中建按住可以调整位置，长按鼠标按住丛雨的头部并左右移动可以摸头……
配置文件
{
"local_api": { #本地api端口，如果api转发远程部署自己改地址
"ollama": "http://localhost:28565/ollama",
"qwen3_lora": "http://localhost:28565/qwen3-lora",
"gpt_sovits_tts": "http://localhost:28565/tts",
"deepseek_api": "http://localhost:28565/deepseekAPI"
},
"portrait": "a", #立绘模式，可以改为b
"user_name": "Kuxw", #用户名字
"model_type": "deepseek", #模型类型，local为本地模型，qwen为qwen系列模型，deepseek为deepseek模型(屏幕识别默认qwen模型，所以建议直接走qwen)
"tts_type": "local", #语音合成，local为本地模型，cloud为云端模型
"screen_type": "false", #屏幕识别开关，false关闭， true开启
"voice_trigger": "false", #语音识别开关
"stt_model": "large-v3", #选择语音识别模型，具体可见原项目
"screen_interval": 300, #屏幕截图间隔(s)
"DEFAULT_PORTRAIT_SCREEN_RATIO": 0.8, #桌宠高度最多占屏幕高度的比例
"screen_index": 0, #桌宠运行在哪个屏幕，并在那个屏幕截图
"idle_thinking_minutes": 1, #短时间离开的判断阈值
"idle_away_minutes": 2 #长时间离开的判断阈值
}
⭐ 如果觉得有用，那请点个 Star 吧！
💬 常见问题（Q&A）
1️⃣ GPU不可用
问题： 有显卡但 TTS 运行时提示
Warning: CUDA is not available, set device to CPU.
解决： 尝试更新显卡驱动，确保 CUDA 与 PyTorch 匹配。
2️⃣ SoVITS 响应慢
问题： SoVITS 有反应但速度极慢。
解决： 请下载与你显卡对应的版本：
- 50 系列：使用 专用版本
- 40 系及以下：使用 通用版本
3️⃣ Conda 激活错误
问题： CondaError: Run 'conda init' before 'conda activate'
解决：
- 建议使用 Miniconda 而非完整版；
- 或在命令行中手动执行：
conda init
4️⃣ API Key 报错
问题： 启动时如图，API 无法使用。
解决：
- 检查 API Key 是否有效、账户余额是否充足；
- 若文件编码问题，重新保存为 ANSI 编码。
5️⃣ start_ai_pet.bat 闪退 （V1.2.0）
问题： 双击启动脚本后直接关闭窗口。
解决：
- 确保路径中 没有特殊符号或空格。
（如中文名、括号、感叹号等）
6️⃣ 脚本乱码或闪退 （V1.2.0）
问题： env.bat 或 start_ai_pet.bat 乱码、无法运行。
解决：
开发任务
| 状态 | 任务 |
|:--:|:--|
| ✅ | 长期记忆功能 |
| ✅ | 桌宠显示大小写入配置文件 |
| ✅ | 添加 Q&A 支持，解决部分常见问题 |
| ✅ | python脚本一键启动，兼容性更高，优化依赖（避免强制下载 PyTorch） |
| ✅ | 更换衣服 |
| | 完成完善的日志记录 |
| | 检查“置顶逻辑”，确保游戏中始终保持窗口置顶 |
| ✅ | tts尝试部署到阿里云 |
| ✅ | 全部模型改用 Qwen 系列 |
Ecosystem Role
Standard MoltPulse indexed agent.
Embed Badge
Show off your Pulse Score in your GitHub README to build trust and rank higher.
[](https://molt-pulse.com/agents/kuxiaowo/AIpet-Murasame)
