⚠️ 免责声明:本项目仅供学习交流使用。角色模型版权归原作者及版权方所有,请勿用于商业用途。详情见 DISCLAIMER.md。
你是否曾幻想过香澄每天早上对你喊「キラキラドキドキ!」?你是否想在工作摸鱼的时候让友希那在一旁冷冷地盯着你(然后偷偷露出猫耳)?你是否想让爱音在你桌面上炫耀她刚学会的吉他 riff?你是否想把祥子和灯放在同一张桌面上上演属于你的 MyGO×AveMujica 小剧场……
现在,你的梦想实现了!!!
BandoriPet 是一个基于 Live2D Cubism SDK 和 PySide6 的开源桌面宠物项目,支持 51+ 位 BanG Dream! 角色、305+ 套服装,让你的桌面一秒变成 CiRCLE 排练室!
QQ群:1033517952

✨ 特性
- ⚡ 自研 LuaJIT 渲染核心 — 基于 Live2D-v2-Lua(作者 @HELPMEEADICE),纯 LuaJIT 实现,性能相较原 live2d-py 提升 6 倍+(30fps → 180fps+),支持头部追踪、拖拽移动、点击互动,老婆会跟着你的鼠标转头!
- 💬 LLM 角色扮演 + 好感度记忆系统 — 接入大语言模型,每个角色都有专属 System Prompt,支持中日英多语言 + 动作标签。交互越多角色越了解你,好感度影响情绪和回复风格,支持人设方案保存/切换。
- 🎨 像素风桌面宠物 — 也可以切成像素小人的形态,CPU 友好,可爱不减!
- 🌓 Fluent Design 设置面板 — 暗色/亮色主题切换,图形化选角选装界面。支持简中、繁中、英文、日文、葡萄牙语、西班牙语、法语、德语、俄语 i18n 国际化。
- 📌 始终置顶 + 无边框 — 趴在你的窗口上方,赶都赶不走(误)。
- 🔔 系统托盘 — 右键一键切角色 / 开设置 / 优雅退场。
- 🔊 TTS 语音合成 — 接入 Qwen3TTS 后端,角色说话时自动语音播放 + Live2D 口型同步,支持中日英多语言。
- 🎙️ ASR 语音输入 — 支持一键安装本地 faster-whisper 后端,也可接入 OpenAI-compatible 语音识别服务,把麦克风录音转成聊天输入文本,详见 ASR_VOICE_INPUT_GUIDE.md。
- 🔗 聊天软件接入 — 本地 Webhook 端口可接收 QQ/微信/Telegram/Discord 等机器人转发消息,设置页支持复制地址、生成 Token 和一键测试。
- 👥 多角色同时显示 — 不止一个!你想放几个就放几个(只要你 GPU 撑得住)。
- 🤖 MCP + Computer Use 支持 — 通过 MCP 协议集成文件系统操作、浏览器控制等 AI Agent 扩展能力,让角色拥有"手"和"眼睛"。
- 🌐 多 LLM 后端 & 搜索增强 — 支持多组 API 配置切换,多后端同时在线,内置 Bing/Google 等多搜索引擎增强检索。
📦 快速开始
1. 环境要求
- Python 3.10+ & LuaJIT 2.1+
- Windows, macOS, Linux(Wayland 原生支持 Plasma 6、GNOME 46+、Hyprland)
- 支持 OpenGL 3.3+ 的显卡(核显也能跑)
- Live2D 默认启用 Qt 硬件 OpenGL/GPU 加速;如需排查驱动问题,可设置
BANDORI_GPU_ACCELERATION=0临时切换到软件渲染。
2. 克隆仓库
git clone https://github.com/HELPMEEADICE/BANDORI-PET-REV.git
cd BANDORI-PET-REV
3. 下载模型文件(必需!)
💡 推荐:zstd 压缩流格式模型包(~900MB,流式加载无需解压到磁盘,性能损失极低)
下载渠道 链接 🚀 ModelScope models.zip ☁️ Google Drive 下载 🐌 百度网盘 下载 提取码: 3724
🚨 传统 7z 模型包(~4GB,需解压到磁盘)
下载渠道 链接 🚀 ModelScope models.7z ☁️ Google Drive 下载 🐌 百度网盘 下载 提取码: 3724
下载后将 models/ 放入项目根目录。若使用 7z 包,解压后的目录结构应为:
BandoriPet/
├── models/
│ ├── kasumi/
│ ├── yukina/
│ ├── anon/
│ ├── tomorin/
│ └── ...
4. 创建虚拟环境 & 安装依赖
💡 强烈建议在虚拟环境中运行,避免与系统全局 Python 包冲突。
创建虚拟环境:
python -m venv venv
激活虚拟环境:
| 平台 | 命令 |
|---|---|
| Windows | venv\Scripts\activate |
| Linux / macOS | source venv/bin/activate |
激活后终端前面会出现 (venv) 提示符。
Python 包(Windows / Linux):
pip install -r requirements.txt
Wayland 用户: Plasma/Hyprland 的 layer-shell 桥必须与系统 Qt/PySide6 使用完全相同的 Qt minor,不能使用 PyPI PySide6 wheel。请改用
requirements-linux-wayland.txt并按照 原生 Wayland 运行指南 安装 Qt Wayland、 LayerShellQt、KWin/GNOME 伴侣及构建桥接。应用在 Wayland 会话中不会回退到 XWayland。
第三方依赖(从源码编译时需要):
mkdir third_party
# PyQt-Fluent-Widgets(必须用 PySide6 分支!)
git clone -b PySide6 --single-branch https://github.com/zhiyiYo/PyQt-Fluent-Widgets.git third_party/PyQt-Fluent-Widgets
pip install -e third_party/PyQt-Fluent-Widgets
# Live2D-v2-Lua(自研 LuaJIT Live2D 渲染核心,无需 pip install)
git clone https://github.com/EasyLive2D/Live2D-v2-Lua.git third_party/Live2D-v2-Lua
Python 包(macOS 源码运行):
No comments yet.