BandoriPet：开源BanG Dream! AI桌宠，高性能Live2D角色互动与TTS语音同步

原创发布日期：2026-07-02

一、BandoriPet是什么

BandoriPet是一款面向BanG Dream!（邦邦）爱好者的开源免费Live2D桌面宠物工具，基于Python+自研LuaJIT Live2D渲染内核开发，托管于GitHub开源仓库，代码采用GPLv3协议开放共享。软件核心作用是将51名邦邦全系列角色以Live2D动态形象悬浮在电脑桌面，打破传统静态桌宠局限，搭配大语言模型实现角色拟人对话、TTS真人语音同步口型交互，同时提供轻量化像素宠物模式，兼顾颜值、性能与AI互动能力，是专为邦邦IP打造的二次元桌面陪伴程序。

区别于普通桌面挂件，BandoriPet完整覆盖Poppin'Party、MyGO!!!!!、Ave Mujica等全部官方乐队角色，内置305+套角色服装，原生搭载LLM角色扮演系统，每个角色配备专属人设Prompt，支持中日英三语对话、角色记忆关系存储；自研渲染引擎相比传统live2d-py性能提升6倍，最高180fps流畅运行，支持鼠标跟随转头、拖拽、点击互动、多角色同屏置顶显示。软件配套完整可视化设置面板、系统托盘快捷操作、开机自启、跨平台兼容补丁，还开放社区二次开发接口，用户可自定义像素角色、补充角色对话人设，所有功能无内置广告、无强制付费，仅角色美术资源版权归属原作厂商，仅限个人非商用使用。

二、软件功能

高性能Live2D动态桌宠
自研LuaJIT渲染核心，支持头部追踪、拖拽移动、点击触发角色动作；可同时加载多名角色无边框置顶悬浮，搭配圆盘右键快捷菜单切换形象。
LLM智能角色对话系统
内置40+角色专属角色扮演Prompt，支持多模态图片输入、网页搜索联动；搭载关系记忆模块，记录与角色互动剧情，支持多语言流式对话输出。
Qwen3TTS语音合成（口型同步）
内置47位角色日文参考音频实现声线克隆，提供0.6b轻量、1.7b高音质两种本地TTS模型；角色说话时Live2D模型自动同步口型，语音多语言自由切换。
双形态宠物切换
Live2D高清动态模型+像素风低占用小人双模式，像素模式大幅降低CPU占用，适合低配电脑长时间运行。
可视化自定义设置
Fluent Design风格设置面板，明暗双主题；支持角色/服装一键切换、隐藏模型、待机动作开关、置顶周期调节、API参数保存切换、多语言国际化。
多平台兼容与稳定优化
原生适配Windows系统，附带macOS专属修复补丁、XWayland兼容方案；修复数据库、窗口渲染、流媒体、进程通信等各类稳定性BUG。
打包与社区拓展能力
提供ZSTD模型压缩工具，支持流式加载免解压模型；使用cx_Freeze可打包独立exe程序；开放像素素材、角色Prompt自定义渠道，支持用户提交PR扩充内容。

三、软件特色

对比维度	BandoriPet 特色优势	普通二次元桌面宠物
渲染性能	LuaJIT自研内核，性能提升6倍，最高180fps，低显存占用	基于live2d-py，帧率仅30fps，卡顿明显
IP资源完整度	51名邦邦全角色、305+套服装，覆盖全乐队	仅少量零散角色，服装缺失严重
AI交互能力	LLM角色扮演+角色记忆+TTS声线克隆+口型同步	无AI对话，仅静态点击动画，无语音
运行模式	Live2D高清/像素轻量化双形态自由切换	仅单一Live2D模式，低配设备负载高
开源自由度	GPLv3开源，支持自定义像素角色、Prompt、模型压缩	闭源/轻量化开源，无法二次拓展角色
模型加载	ZSTD流式900MB压缩包（免解压）/4GB完整7z包双选项	仅完整解压大包，占用大量磁盘空间

四、使用方法

1. 前置环境要求

Python 3.10+、LuaJIT 2.1+
显卡支持OpenGL 3.3+（核显可正常运行）
主力适配Windows，附带macOS兼容补丁

2. 完整部署步骤

克隆项目仓库
打开终端执行命令：git clone https://github.com/HELPMEEADICE/BANDORI-PET-REV.git，进入项目文件夹cd BANDORI-PET-REV
下载角色模型（必备）
二选一下载模型包，解压/放置models文件夹至项目根目录：

轻量化推荐：ZSTD流式包（900MB，无需完整解压）
完整资源包：7z压缩包（4GB，需全部解压）
下载渠道：ModelScope、Google Drive、百度网盘（提取码3724）

安装全部依赖
执行pip install -r requirements.txt；手动克隆编译PyQt-Fluent-Widgets（PySide6分支）、Live2D-v2-Lua自研渲染内核至third_party目录
启动主程序
终端输入python main.py，软件自动弹出桌面宠物与设置窗口
可选：开启TTS语音功能
下载Qwen3TTS本地推理模型（0.6b/1.7b），启动本地API服务（默认127.0.0.1:9880），在软件设置-TTS面板开启语音克隆与口型同步。

3. 打包独立exe（开发者使用）

执行python setup.py build，打包产物输出至BUILD文件夹，模型文件需用户自行下载放入目录。

五、收费价格

BandoriPet为100%永久免费开源软件，无任何付费功能、无会员、无内购、无广告：

项目代码GitHub公开，任何人可免费克隆、下载、修改、本地部署；
角色模型、TTS模型均提供免费多渠道分流下载，无需付费解锁；
商用限制：软件代码可遵循GPLv3开源协议二次分发，但BanG Dream!角色Live2D模型、贴图、音频版权归原厂商Bushiroad所有，严禁用于任何商业盈利场景。

六、常见问题解答（FAQ）

Q1：低配电脑运行卡顿怎么办？

A：切换像素宠物模式，关闭多角色同屏，选用0.6b轻量化TTS模型，使用ZSTD流式模型包降低磁盘读取压力。

Q2：macOS启动报错、窗口异常如何解决？

A：项目内置macos_patch.py专用补丁，运行补丁文件修复窗口行为、PySide6启动兼容BUG。

Q3：AI对话角色没有专属人设怎么补充？

A：参考项目内PROMPT.md模板，在characters文件夹新增角色Prompt文件，完成后可提交PR合并至官方仓库。

Q4：模型下载速度太慢有替代渠道吗？

A：提供ModelScope、Google Drive、百度网盘（提取码3724）三条下载通道，国内优先选择百度网盘/ModelScope。

Q5：能否同时在桌面放置多个不同角色？

A：支持多角色同屏显示，数量仅受显卡显存限制，右键托盘圆盘菜单可快速新增/移除角色。

Q6：软件是否支持Linux系统？

A：提供XWayland兼容适配代码，可在Linux环境运行，但官方优先维护Windows与macOS平台。

七、总结

BandoriPet是目前BanG Dream!同人圈功能最完整、性能最优的开源AI桌面宠物工具，依托自研LuaJIT Live2D渲染引擎解决传统桌宠卡顿痛点，打通Live2D动态形象、大模型拟人对话、角色专属TTS语音三大核心体验。软件兼顾普通玩家轻量化使用与开发者二次拓展需求，双形态模型、完整角色资源、免费开源无付费门槛降低使用门槛；同时完善跨平台兼容、可视化设置、社区共建机制，为邦邦爱好者打造可互动、可对话、可自定义的桌面虚拟陪伴，适合日常办公、摸鱼休闲、同人创作等场景，所有代码永久免费开放，仅角色美术资源受原作版权约束禁止商用。