一个具备长时记忆与多模态感知能力的多平台 AI 虚拟生命

✨ 这是什么？

NachoBot 赋予了 AI 大语言模型一个完整的虚拟灵魂。
采用“核心+多适配器”的设计理念，它可以化身为 Bilibili 直播间的虚拟主播、Discord 语音频道的陪玩伙伴，或是活跃在 QQ 群里的赛博老婆。

• GPT-SoVITS / VoxCPM 托管式 TTS，以及极低延迟的本地流式 ASR、Florence-2 VLM。
  
• 语音文本情感分类，根据分类结果自动选择至最合适的语气进行生成。
  
• Discord 原生语音通话模式，通过官方接口获取音频流。
• 通用语音适配器可接入任意平台做到监听与回复。
• 人物画像跨平台绑定，长期记忆完美迁移。
• 通过 BiliBili API 获取私信/评论/直播弹幕等消息。
• BiliBili 直播已接入 Live2D 驱动模型。
• 针对直播场景特别优化的消息处理管线。
• 优质插件集成与优化。
• 麦麦插件市场已兼容。
• WebUI 一键部署、进程与配置管理、数据库浏览、以及网页聊天。

🚀 快速开始

推荐环境为 Windows 10/11、Python 3.11 或 3.12；Discord 接入还需要 Node.js。首次同步依赖或下载本地模型会耗时较久。

1. 运行 launch_webui.bat。
2. 在WebUI“部署向导”中完成环境检查、平台选择和配置生成，再到“一键启动”管理服务。

也可以部署后使用根目录脚本：

脚本	用途
launchbot.bat	Core + NapCat + 托管 TTS + VLM/ASR
launchbot_lite.bat	Core + NapCat + 托管 TTS，不启动 VLM/ASR
launchbot_potato.bat	Core + NapCat + 纯消息中继，不加载任何本地模型
launch_bilibili.bat	Bilibili；按配置复用或启动独立 Live2D
launch_discord.bat	Koishi 文字适配器 + DiscordVC
launch_universal_vc.bat	通用进程音频捕获、流式 ASR 与虚拟声卡输出

三个 launchbot* 档位都以 QQ/NapCat 主链路为基础；Bilibili、Discord 和 UniversalVC 按需另行启动。

组件导航

🧠 1. 核心引擎

负责大语言模型接入、记忆管理、指令解析与全局配置
👉 NachoBot 核心模块详解与基础安装

🔌 2. 平台通讯适配器

📺 Bilibili 适配器：直播间弹幕互动、扫码登录、Live2D 联动配置
🎮 Discord 适配器：Slash 指令、语音频道发言
🐱 NapCat 适配器：QQ 消息收发与心跳重连机制
🌐 Koishi 框架：Discord 接入的底层依赖与插件管理

🗣️ 3. 感知与表现层

🎵 多模态适配器：文本转语音、视觉理解与语音识别的本地服务启动

更新、贡献与许可

• 项目更新摘要：NachoBot Updates
• 贡献指南：CONTRIBUTING.md
• 行为准则：CODE_OF_CONDUCT.md

本项目采用 GPLv3。感谢 MaiBot、NapCat、Koishi、GPT-SoVITS、VoxCPM 及其他上游开源项目。