WhisperX 指南
WhisperX 本地安装：环境准备与排错
按照上游当前要求准备独立 Python 环境、CPU 或兼容 GPU，以及 FFmpeg。
WhisperX 团队 · 审阅日期：2026 年 10 月 15 日
先看当前版本要求
选择 Python、PyTorch 和 CUDA 版本前，先查阅对应版本的 README。依赖会变化，本指南不代表所有命令已在你的系统上验证。
使用独立环境
新建虚拟环境，保存安装版本和依赖锁定文件。需要可复现环境时，优先使用稳定版本的安装说明。
检查 CPU、GPU 与 FFmpeg
可以使用 CPU。GPU 加速需要兼容驱动及软件库，仅安装 CUDA 并不足够。常见媒体格式需要 FFmpeg。先用短文件验证。
最后再加说话人分离
先确认转录和对齐正常，再按上游说明配置模型访问，用自己的账户接受许可，并把令牌保存在版本库之外。
逐层定位问题
找不到命令先查环境；CUDA 加载失败查驱动和库；内存不足尝试减小批量；模型拒绝访问查权限。分享日志前清除令牌和私人路径。
选择适合的运行方式
本地安装便于控制配置和数据位置。托管服务负责维护环境，适合希望直接上传、核对和导出的人。
python -m venv .venv
# 先按所用 shell 的方式激活 .venv
python -m pip install --upgrade pip
python -m pip install whisperx
whisperx recording.wav --device cpu --compute_type int8