BANDORI PET REV

BandoriPet 是一个基于 Live2D 和 PySide6 的开源桌面宠物项目,支持 50+ 位 BanG Dream! 角色、3000+ 套服装,让你的桌面一秒变成 CiRCLE 排练室

LLM Mart 7 views 429k listing impressions

⚠️ 免责声明:本项目仅供学习交流使用。角色模型版权归原作者及版权方所有,请勿用于商业用途。详情见 DISCLAIMER.md。

你是否曾幻想过香澄每天早上对你喊「キラキラドキドキ!」?你是否想在工作摸鱼的时候让友希那在一旁冷冷地盯着你(然后偷偷露出猫耳)?你是否想让爱音在你桌面上炫耀她刚学会的吉他 riff?你是否想把祥子和灯放在同一张桌面上上演属于你的 MyGO×AveMujica 小剧场……

现在,你的梦想实现了!!!

BandoriPet 是一个基于 Live2D Cubism SDK 和 PySide6 的开源桌面宠物项目,支持 51+ 位 BanG Dream! 角色、305+ 套服装,让你的桌面一秒变成 CiRCLE 排练室!

QQ群:1033517952

Example


✨ 特性

  • ⚡ 自研 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 源码运行):

From the project's README.

Comments (0)

Sign in to join the conversation.

No comments yet.