当前位置：首页 > news >正文

AI【应用 03】Windows环境部署 TTS CosyVoice2.0 详细流程记录（Matcha-TTS、spk2info.pt等文件分享）

news 2025/7/11 5:57:46

通过网盘分享的文件：CSDN_CosyVoice

链接: https://pan.baidu.com/s/1dJvB3vAnEQ9Li8PFvqhbzQ?pwd=3ngj 提取码: 3ngj

包含全部离线使用文件：

CosyVoice2-0.5B（全量数据）
CosyVoice-testFiles（生成的音频）
CosyVoice-main.zip
Matcha-TTS-main.zip
spk2info.pt
torch-2.3.1+cu121-cp310-cp310-win_amd64.whl
Windows环境部署 TTS CosyVoice2.0 详细流程记录
- 1.离线部署
- - 1.1 文件下载
  - 1.2 环境搭建
  - 1.3 运行报错
  - - 1.3.1 报错 1
    - 1.3.2 报错 2
- 2.正式测试
- 3.简单总结

1.离线部署

CosyVoice 2.0 已发布！与 1.0 版相比，新版本提供了更准确、更稳定、更快和更好的语音生成能力。关注技术细节的可以看看官网的《介绍》。源码里的 README.md文件详细描述了 2.0 的新特性、安装、模型下载和使用方法，本文主要记录一个小白的本地部署完整过程。部署环境为一台老旧的没有 GPU 的台式机：

1.1 文件下载

话不多说了，进入主题，先下载源码和模型文件：

源码（1.17MB） https://github.com/FunAudioLLM/CosyVoice
模型（3.9GB） https://www.modelscope.cn/models/iic/CosyVoice2-0.5B

模型文件列表：

1.2 环境搭建

Python 代码的运行需要各种依赖，也是最让小白头疼的地方，使用Anaconda会方便很多，以下是官网的搭建脚本：

# 创建虚拟环境
conda create -n cosyvoice -y python=3.10
conda activate cosyvoice# 安装依赖
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com

安装过程出现的问题：

# 无法下载 torch
Collecting torch==2.3.1 (from -r requirements.txt (line 35))Downloading https://download.pytorch.org/whl/cu121/torch-2.3.1%2Bcu121-cp310-cp310-win_amd64.whl (2423.5 MB)- -------------------------------------- 0.1/2.4 GB 1.8 MB/s eta 0:22:10WARNING: Connection timed out while downloading.# 在另一台 Linux 电脑上下载
wget -c https://download.pytorch.org/whl/cu121/torch-2.3.1%2Bcu121-cp310-cp310-win_amd64.whl# 进行离线安装
pip install .\torch-2.3.1+cu121-cp310-cp310-win_amd64.whl -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com

离线安装 torch-2.3.1+cu121-cp310-cp310-win_amd64.whl后继续使用 pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com安装其他依赖。

1.3 运行报错

修改 --model_dir的默认目录：

if __name__ == '__main__':parser = argparse.ArgumentParser()parser.add_argument('--port',type=int,default=8000)parser.add_argument('--model_dir',type=str,default=r'D:\tmp\CosyVoice2-0.5B',help='local path or modelscope repo id')

运行 webui.py，或使用命令运行：

python pathTo\webui.py --port 50000 --model_dir pathTo\CosyVoice2-0.5B\

1.3.1 报错 1

启动时报 pydoc.ErrorDuringImport: problem in cosyvoice.flow.flow_matching - ModuleNotFoundError: No module named 'matcha' 错误：

使用命令 pip install matcha后，再次启动报pydoc.ErrorDuringImport: problem in cosyvoice.flow.flow_matching - ModuleNotFoundError: No module named 'matcha.models';'matcha' is not a package 错误：

解决办法，下载 Matcha-TTS源码，解压到 third_party\Matcha-TTS目录下：

再次启动，访问 localhost:8000即可打开如下界面：

不能高兴的太早！

1.3.2 报错 2

    embedding = self.spk2info[spk_id]['embedding']
KeyError: ''

启动时已初见端倪：

源码里有 spk2info.pt的配置：

self.frontend = CosyVoiceFrontEnd(configs['get_tokenizer'],configs['feat_extractor'],'{}/campplus.onnx'.format(model_dir),'{}/speech_tokenizer_v1.onnx'.format(model_dir),'{}/spk2info.pt'.format(model_dir),configs['allowed_special'])