Genie-TTS

环境要求

• Python 版本 >= 3.10
• 操作系统需支持音频播放（推理在 CPU 上运行）
• 建议以管理员模式运行，避免性能下降
• 首次运行需联网，程序会自动下载所需模型文件
• 仅支持 GPT-SoVITS V2、V2ProPlus 模型

安装与启动步骤

1. 1确认 Python 版本

   先检查本机 Python 是否为 3.10 或更高版本，版本过低需先升级 Python 环境。

2. 2安装 genie-tts

   用 pip 从 PyPI 安装 genie-tts 包，安装完成后即可在 Python 中导入使用。

   pip install genie-tts

   复制

3. 3以管理员模式运行

   Windows 下建议用管理员身份打开终端/编辑器再执行脚本，避免推理性能下降。

4. 4加载预置角色

   首次运行会自动下载所需文件，需要联网并耐心等待下载完成。

   import genie
   
   genie.load_predefined_character('mika')

   复制

5. 5运行语音合成

   character_name 必须与已加载的角色名一致，save_path 为输出音频路径，可自行修改。

   import genie
   
   genie.load_predefined_character('mika')
   
   genie.tts(
       character_name='mika',
       text='どうしようかな……やっぱりやりたいかも……！',
       play=True,
       save_path='output.wav',
   )
   
   genie.wait_for_playback_done()
   
   print(" Audio generation complete!")

   复制

关键配置

如何确认成功

终端打印 “ Audio generation complete!”，并能听到合成语音、在指定路径看到输出音频文件，即为成功。

常见问题

注意事项

• README 建议以管理员模式运行，避免性能下降。
• 首次运行会自动下载所需文件，必须联网。
• 推理在 CPU 上运行，官方称首次推理延迟约 1.13s。
• README 未提供 git clone 源码部署与 ONNX 转换的具体命令，本教程仅覆盖 pip 安装与推理用法。