AI-Waifu-Vtuber

环境要求

• 已安装 Python 环境（项目基于 Python，需能执行 pip）
• OpenAI API Key（用于对话生成）
• Twitch 直播场景需申请 OAuth Token（https://twitchapps.com/tmi/）
• 日语语音需 VoiceVox Engine（官方 Docker 镜像或 Colab 笔记本）
• 其他语言语音可改用 Silero TTS，翻译可选用 DeepL / DeepLX

安装与启动步骤

1. 1获取项目代码

   从 GitHub 克隆项目到本地，进入项目根目录后再执行后续安装。仓库地址取自项目 GitHub 页。

   git clone https://github.com/ardha27/AI-Waifu-Vtuber.git
   cd AI-Waifu-Vtuber

   复制

2. 2安装依赖

   在项目根目录执行，requirements.txt 会一次性装上所需 Python 依赖。建议先建虚拟环境隔离开。

   pip install -r requirements.txt

   复制

3. 3创建配置文件

   新建 config.py，按 README 填入 OpenAI API Key 和主人名字，二者是必填项。

   api_key = 'sk-xxxxxxxx'
   owner_name = "Ardha"

   复制

4. 4设置直播黑名单

   若要用于直播，在 run.py 里维护一份不想回复的用户名单，避免机器人账号刷屏被复读。

   blacklist = ["Nightbot", "streamelements"]

   复制

5. 5编辑角色人设

   修改 characterConfig/Pina/identity.txt，写入你希望 AI 角色的设定与说话风格。

6. 6配置 Twitch（可选）

   想读 Twitch 弹幕就改 utils/twitch_config.py，token 从 twitchapps.com/tmi 获取；之后用 Mode 3 启动。

   server = 'irc.chat.twitch.tv'
   port = 6667
   nickname = 'testing'
   token = 'oauth:43rip6j6fgio8n5xly1oum1lph8ikl1'
   user = 'ardha27'
   channel = '#aikohound'

   复制

7. 7切换 TTS 引擎

   在 run.py 中通过注释/取消注释在两个 TTS 之间切换：voicevox_tts 为日语，seliro_tts 支持多语言。

   # voicevox_tts
   seliro_tts

   复制

8. 8启动程序

   运行主程序，按提示选择模式；Twitch 直播场景选 Mode - 3。README 未给出显式启动命令。

   python run.py

   复制

关键配置

如何确认成功

程序无报错运行，对它说话能被识别并得到语音回复；Twitch 模式下能读取并回复弹幕。

常见问题

注意事项

• README 未给出明确的启动命令，此处以 python run.py 为准，实际请以仓库最新说明为准。
• VoiceVox 与 Silero 的切换靠 run.py 内注释/取消注释，切错会没有语音输出。
• config.py 中的 API Key 与 Twitch token 属于敏感信息，不要提交到公开仓库。
• Twitch 配置项在 README 中 key 名为 user，不是 username，注意不要写错。