跳到主要内容

手把手安装whisper语音转文本字幕

1. python管理器uv的安装

方式1 懒人一键脚本

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

执行上述脚本后-->
会默认下载uv.exe文件到%USERPROFILE%\.local\bin
日后的缓存会放到%LOCALAPPDATA%\uv\
解释器目录会放到%APPDATA% 这些都是用户的家目录,也就是C盘,这些目录会随着模型下载增多而变大。大约10Gb左右,如果C盘空间大,没问题。如果不能忍受,请使用方式2。

方式2 手动安装到D盘。

① 去github官方下载最新版 https://github.com/astral-sh/uv/releases
一般windows用户选择uv-x86_64-pc-windows-msvc.zip下载即可,版本最新就行。

② 先不着急解压,打开powershell分别执行下面的5条命令,来改变uv的默认路径。
参考文档:https://docs.astral.sh/uv/reference/environment/

# 1. 设置 uv.exe 程序的安装目录
[Environment]::SetEnvironmentVariable("UV_INSTALL_DIR", "D:\dev\uv\bin", "User")

# 2. 设置 Python 启动器 (shims) 的存放目录
[Environment]::SetEnvironmentVariable("UV_PYTHON_BIN_DIR", "D:\dev\uv\bin", "User")

# 3. 设置 Python 解释器本体存放目录
[Environment]::SetEnvironmentVariable("UV_PYTHON_INSTALL_DIR", "D:\dev\uv\python", "User")

# 4. 设置缓存目录 (包和模型)
[Environment]::SetEnvironmentVariable("UV_CACHE_DIR", "D:\dev\uv\cache", "User")

# 5. 设置全局工具目录
[Environment]::SetEnvironmentVariable("UV_TOOL_DIR", "D:\dev\uv\tools", "User")

③ 这时候解压之前下载的压缩包,把里面的exe文件都放入到D:\dev\uv\bin,另外再把这个路径加入到系统Path,方便uv命令全局使用。 至此,UA已经安装完成。

2. 使用uv安装python

关闭所有powershell,然后重新打开powershell执行

# ①安装3.11版本的python
uv python install 3.11

# ②创建D:\dev\Whisper目录并进入,然后在这个目录右击打开终端,执行命令来创建虚拟环境
uv venv --python 3.11

# ③激活环境
.\.venv\Scripts\activate

3. ffmpeg的安装(推荐全局)

这个推荐全局安装就好,毕竟很多应用都用。点击这里下载官方ffmpeg-essentials

下载完成后解压,把bin文件夹下的三个exe文件,放到自己喜欢的路径下面,我这里是D:\dev\ffmpeg\bin然后添加该路径到系统环境变量,以便全局使用。

4.安装pytorch

先去下面链接的pytorch官网获取对应的下载指令。
链接: https://pytorch.org/get-started/locally/

需要注意的是:上述链接获取的下载命令需要做一下修改,例如我获取到的命令是:

pip3 install torch torchvision --index-url https://download.pytorch.org/whl/cu130

把开头的pip3改为uv pip因为我们用的是uv来管理的python,得到:

uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu130

5.安装whisper

官方安装(海外)

uv pip install -U openai-whisper

清华源安装(中国大陆)

uv pip install -U openai-whisper -i https://pypi.tuna.tsinghua.edu.cn/simple

6.使用whisper

点击这里下载whisper.bat,双击运行即可。
注意:脚本里面我默认把Whisper安装到了D:\dev\Whisper,如果和我不一样,请自行打开脚本,并修改这一行为自己的目录位置
set "PROJECT_DIR=D:\dev\Whisper"