跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

Whisper 环境部署手记

搭建 Whisper 语音识别环境的全过程记录,涵盖 Python、PyTorch、Whisper 库和 FFmpeg 的安装配置。文中详细列举了 CPU 与 GPU 环境的安装命令、常见错误处理,并建议使用虚拟环境隔离依赖、根据硬件选择合适大小的模型。

深海蔚蓝发布于 2026/6/20更新于 2026/10/2478 浏览

起步

第一次用 Whisper 时,我照着官方 README 搭环境,本以为几条命令搞定,结果踩了几个小坑。写下来给后来者提个醒。

系统方面,Whisper 支持 Windows、macOS 和 Linux。Python 版本建议 3.8 到 3.11,我用的 3.10。PyTorch 会跟着 Whisper 自动装,但提前了解怎么装 CPU/GPU 版能省不少事。内存 4G 以上就行,有 NVIDIA 显卡最好,没有也能用 CPU 慢慢跑。

安装 Python

去Python 官网下载对应版本。Windows 安装时一定勾上'Add Python to PATH',免得后续敲路径。macOS 装 .pkg,一路下一步。Linux 就用包管理器:

sudo apt update && sudo apt install python3 python3-pip   # Ubuntu/Debian

装完检查一下版本:

python --version
pip --version

能正常显示版本就 ok。我习惯用 venv 隔离环境,后头细说。

装 PyTorch

Whisper 跑在 PyTorch 上,所以得先装。官方的安装指导页会根据你的系统生成命令。

没 GPU 或者图省事,直接装 CPU 版:

pip3 install torch torchvision torchaudio

有 NVIDIA 显卡的话,留意 CUDA 版本。我手头的机器 CUDA 11.8,所以用:

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

如果你装的 CUDA 12.1,把链接里的 cu118 换成 cu121。

验证一下有没有装对:

import torch
print(torch.__version__)
print(torch.cuda.is_available())

第二行 True 就说明 GPU 能用了;False 就是只跑 CPU。

装 Whisper

最省心的方式是用 pip:

pip install -U openai-whisper

想追最新功能,直接从 GitHub 仓库拉:

pip install git+https://github.com/openai/whisper.git

如果之前装过,更新时可能会遇到依赖冲突,加 --force-reinstall 强装一把:

pip install --upgrade --no-deps --force-reinstall git+https://github.com/openai/whisper.git

配置 FFmpeg

Whisper 处理音频需要 FFmpeg,而且必须能在命令行直接调用。也就是说,得把它的可执行文件路径加到 PATH 里。

Windows 用户去 gyan.dev 下载 build,解压后把 文件夹路径加到系统环境变量。macOS 用 Homebrew 一条搞定:

bin
brew install ffmpeg

Linux 也是包管理器解决:

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg
# CentOS/RHEL
sudo yum install ffmpeg
# Arch
sudo pacman -S ffmpeg

装完敲 ffmpeg -version,没报错就妥了。我那次在 Windows 下忘加 PATH,whisper 命令怎么都找不到 ffmpeg,重启终端才解决。

可能需要的其他依赖

如果在导入时碰到 No module named 'setuptools_rust',装一下:

pip install setuptools-rust

还有时候 tiktoken 报错要求 Rust 环境,那就先去装 Rust,再重装 Whisper。

验证

命令行下试试:

whisper --help

有输出说明 CLI 能用了。

再跑段 Python 确认 API 没问题:

import whisper

try:
    model = whisper.load_model("tiny")
    print("模型加载成功!")
    print("可用模型:", whisper.available_models())
except Exception as e:
    print(f"安装失败:{e}")

第一次运行会下载 tiny 模型,等一会就行。以后再用就不会重复下载了。

常踩的坑

权限问题:加 --user 安装或者用管理员权限运行。

模型下载不了:检查网络,或者开个代理。实在不行可以手动下模型放到 ~/.cache/whisper 目录。

FFmpeg 找不到:确认 PATH 对了,不行就重启终端或电脑。Windows 尤其容易忘这步。

CUDA 报错:确保显卡驱动和 PyTorch 的 CUDA 版本匹配。临时切回 CPU 版本跑一下,能过就是 GPU 环境的问题。

Python 版本不兼容:老老实实用 3.8 到 3.11。开个 venv 吧,别跟系统 Python 打架。

实用建议

建个虚拟环境,就跟其它 Python 项目一样:

python -m venv whisper-env
# 激活
# Windows: whisper-env\Scripts\activate
# Linux/macOS: source whisper-env/bin/activate

然后在里面装 Whisper,别污染全局。

模型选择上,内存吃紧就 tiny 或 base;精度优先上 medium 或 large;图快就用 turbo,它牺牲一点精度换速度。

OpenAI 会持续更新模型和代码,时不时跑一下 pip install -U openai-whisper 保持最新。


环境搭完,下一步就可以转录音频了。

目录

  1. 起步
  2. 安装 Python
  3. 装 PyTorch
  4. 装 Whisper
  5. 配置 FFmpeg
  6. Ubuntu/Debian
  7. CentOS/RHEL
  8. Arch
  9. 可能需要的其他依赖
  10. 验证
  11. 常踩的坑
  12. 实用建议
  13. 激活
  14. Windows: whisper-env\Scripts\activate
  15. Linux/macOS: source whisper-env/bin/activate

更多推荐文章

查看全部
  • Claude Skills 实战:自动化工具安装与使用指南
  • 清华团队发布OpenClaw研究报告:AI智能体生态闭环解析
  • 2026 主流 AI 编程助手深度评测:文心快码、Copilot 与 Cursor
  • Virt A Mate (VAM) 虚拟现实模拟软件功能介绍
  • 从 HTAP 到 AI 加速,KingbaseES 的技术演进之路
  • C++ 从零实现 TCP Socket 网络通信工具
  • FPGA 基础概念与架构面试题解析(一)
  • AI 产品经理必备的 AI 技术知识
  • Lit-LLaMA 大语言模型部署与微调指南
  • Git 工作流程详解:核心概念与主流模式选择
  • bit7z:C++ 压缩解压缩库快速上手指南
  • C++调用PaddleOCR进行图像推理
  • AI 时代技术民主化:文科生为何成为最大受益者
  • Agentic AI 概念解析:与传统 AIGC 的核心区别
  • Ollama Windows 安装与使用指南:本地运行 Llama、DeepSeek 大模型
  • MySQL 详细安装配置与连接实战
  • VSCode Copilot 代码补全准确率优化实战指南
  • 低代码不是终点:走向意图驱动的企业级开发新范式
  • Vue Router 核心功能详解:导航守卫与状态管理
  • 宇树机器人 G1 二次开发:FAST_LIO 建图与 RViz 配置教程

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online