soprano

环境要求

• 已安装 Python 环境与 pip（README 未指定具体版本）
• CPU 或 MPS（Mac）设备可直接用基础包；CUDA 用户需可用的 NVIDIA GPU 环境
• 从源码安装需已安装 git
• Windows + CUDA 用户需在安装后重装 CUDA 版 PyTorch

安装与启动步骤

1. 1准备运行环境

   确认本机已装好 Python 和 pip，按设备类型选择后续安装方式：CPU/MPS 用基础包，CUDA 用带 lmdeploy 的版本。

2. 2安装 CPU/MPS 版

   在 CPU 或 Mac MPS 设备上直接安装官方 wheel 包，无需额外依赖，安装完即可使用。

   pip install soprano-tts

   复制

3. 3安装 CUDA 版

   使用 NVIDIA GPU 时安装带 lmdeploy 扩展的版本，以获得 README 所述的高倍速生成能力。

   pip install soprano-tts[lmdeploy]

   复制

4. 4源码安装 CPU/MPS

   想获取最新功能可从源码安装：先克隆仓库并进入目录，再以可编辑模式安装。

   git clone https://github.com/ekwek1/soprano.git
   cd soprano
   pip install -e .

   复制

5. 5源码安装 CUDA

   CUDA 环境下从源码安装时，末尾的安装命令需加上 [lmdeploy] 扩展，其余步骤相同。

   git clone https://github.com/ekwek1/soprano.git
   cd soprano
   pip install -e .[lmdeploy]

   复制

6. 6修正 Windows CUDA

   Windows 上 pip 会装成 CPU 版 PyTorch，必须按 README 警告在安装 Soprano 之后卸载并重装 CUDA 版 torch。

   pip uninstall -y torch
   pip install torch==2.8.0 --index-url https://download.pytorch.org/whl/cu128

   复制

如何确认成功

README 未提供启动或验证命令，安装过程无报错即表示安装完成。

常见问题

注意事项

• 引用文本时请使用双引号，不要用单引号。
• 合成效果不理想时可重新生成，或调整采样设置以获得更多变化。
• README 中 Usage 章节被截断，WebUI、CLI、OpenAI 兼容接口、ONNX、ComfyUI 的具体启动命令未给出，请查阅完整 README 后再配置。