[AI工具]Fish-speech部署教程(环境搭建记录)
Fish-speech v1.5环境搭建-官方文档
版本不同部署方法是不太一样的, 大家学习的时候记得一定要看对应版本的文档进行学习
本教程围绕windows系统进行配置
1. 下载1.5版本的项目到本地
点击跳转: fish-speech官网地址
2. 管理员身份运行 cmd , 并切入项目根目录
后续安装命令都需要在项目根目录进行
3. 安装 anaconda
点击跳转: anaconda官网地址
填写邮箱获取下载链接, 下载完整版, 不是mini版
安装时勾选 “Add to PATH”
安装完成如果cmd输入conda回车提示错误, 则还需再手动配置系统环境变量:
C:\安装路径\Anaconda3
C:\安装路径\Anaconda3\Scripts
C:\安装路径\Anaconda3\Library\bin
如果正常就看第四步
4. 使用 conda 命令安装依赖
# 创建一个 python 3.10 虚拟环境, 你也可以用 virtualenv
conda create -n fish-speech python=3.10
conda activate fish-speech# 安装 pytorch
pip3 install torch==2.4.1 torchvision==0.19.1 torchaudio==2.4.1 --index-url https://download.pytorch.org/whl/cu121# 安装 fish-speech
pip3 install -e .# (开启编译加速) 安装 triton-windows
pip install https://github.com/AnyaCoder/fish-speech/releases/download/v0.1.0/triton_windows-0.1.0-py3-none-any.whl
5. 下载推理模型
方式一: 通过命令直接下载
set HF_ENDPOINT=https://hf-mirror.com
huggingface-cli download fishaudio/fish-speech-1.5 --local-dir checkpoints/fish-speech-1.5
方式二: 通过网站手动下载
- 点击跳转: 模型官网地址
- 下载fish-speech-1.5文件夹所有文件, pth后缀大文件可用迅雷下载
- 根目录创建 \checkpoints\目录, 并把fish-speech-1.5文件夹放里边即可
6. 推理方式
①.命令行推理; ②.HTTP API 推理; ③.GUI 推理; ④.WebUI 推理;
这里用WebUI演示, 命令行运行:
python -m tools.run_webui --llama-checkpoint-path "checkpoints/fish-speech-1.5" --decoder-checkpoint-path "checkpoints/fish-speech-1.5/firefly-gan-vq-fsq-8x1024-21hz-generator.pth" --decoder-config-name firefly_gan_vq
运行成功, 浏览器访问 127.0.0.1:7860
大功告成, 撒花✿✿ヽ(°▽°)ノ✿
最后附上: Fish-speech v1.5推理-官方文档
一些遇到的报错解决记录
启动 HTTP 服务提示CUDA错误
解决办法:
1. 下载对应的CUDA版本文件
点击下载: CUDA 12.8 Toolkit 官网地址
选择你的系统（Windows 11/10）和安装类型（exe [local]）
2. 运行安装程序
双击下载的 .exe 文件。
选择 自定义安装，确保勾选：
- CUDA → Development Tools（必须）
- CUDA → Runtime Libraries（必须）
3. 验证安装
安装完成后，打开命令提示符，运行：
nvcc --version
应输出：
nvcc: NVIDIA (R) Cuda compiler version 12.8
设置环境变量
如果安装程序未自动添加，手动将以下路径加入 PATH：
C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\bin
新建系统变量 CUDA_PATH，值为：
C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8