安装预构建二进制文件¶
torchaudio
为 PyPI (pip
) 和 Anaconda (conda
) 提供二进制发行版。
有关详细信息,请参阅 https://pytorch.ac.cn/get-started/locally/。
注意
每个 torchaudio
包都是针对特定版本的 torch
编译的。请参阅下表并安装正确的 torch
和 torchaudio
对。
注意
从 0.10
开始,torchaudio 具有仅 CPU 和支持 CUDA 的二进制发行版,每个发行版都需要相应的 PyTorch 发行版。
注意
此软件针对未修改的 FFmpeg 副本编译,并删除了特定 rpath,以便能够使用系统库。LGPL 源代码可以从以下位置下载:n4.1.8 (许可证)、n5.0.3 (许可证) 和 n6.0 (许可证).
依赖项¶
-
请参阅下面的兼容性矩阵以了解支持的 PyTorch 版本。
可选依赖项¶
-
需要使用
torchaudio.io
模块,以及在 I/O 函数 中的backend="ffmpeg"
。从 2.1 版本开始,TorchAudio 官方二进制发行版与 FFmpeg 版本 6、5 和 4 兼容。(>=4.4, <7)。在运行时,TorchAudio 首先查找 FFmpeg 6,如果未找到,则继续查找 5 并继续查找 4。
安装 FFmpeg 库有多种方法。有关如何安装 FFmpeg 的详细信息,请参阅官方文档。如果您使用的是 Anaconda Python 发行版,
conda install -c conda-forge 'ffmpeg<7'
将安装兼容的 FFmpeg 库。如果您需要指定 TorchAudio 搜索和链接的 FFmpeg 版本,可以通过环境变量
TORIO_USE_FFMPEG_VERSION
指定。例如,通过设置TORIO_USE_FFMPEG_VERSION=5
,TorchAudio 将只查找 FFmpeg 5。如果由于某种原因,这种搜索机制会导致问题,可以通过设置环境变量
TORIO_USE_FFMPEG=0
完全禁用 FFmpeg 集成。安装 FFmpeg 库有多种方法。如果您使用的是 Anaconda Python 发行版,
conda install -c conda-forge 'ffmpeg<7'
将安装兼容的 FFmpeg 库。注意
当搜索 FFmpeg 安装时,TorchAudio 会查找包含版本号的库文件。也就是说,对于 Linux 来说是
libavutil.so.<VERSION>
,对于 macOS 来说是libavutil.<VERSION>.dylib
,对于 Windows 来说是avutil-<VERSION>.dll
。许多公共预构建二进制文件遵循这种命名方案,但一些发行版具有非版本化的文件名。如果您在检测 FFmpeg 时遇到困难,请仔细检查您安装的库文件是否遵循这种命名方案(然后确保它们位于库搜索路径中列出的目录之一中)。 -
需要在 I/O 函数 中使用
backend="sox"
。从 2.1 版本开始,TorchAudio 需要单独安装 libsox。
如果动态链接导致问题,您可以设置环境变量
TORCHAUDIO_USE_SOX=0
,TorchAudio 不会使用 SoX。注意
TorchAudio 会查找具有非版本化名称的库文件,即对于 Linux 来说是
libsox.so
,对于 macOS 来说是libsox.dylib
。一些包管理器会安装具有不同名称的库文件。例如,Ubuntu 上的 aptitude 安装的是libsox.so.3
。要让 TorchAudio 链接到它,您可以创建一个名为libsox.so
的符号链接(并将符号链接放在库搜索路径中)。注意
TorchAudio 在 libsox 14.4.2 上经过测试。(其他版本不太可能工作。)
-
需要在 I/O 函数 中使用
backend="soundfile"
。 -
需要使用 Emformer RNN-T 进行自动语音识别。您可以通过运行
pip install sentencepiece
来安装它。 -
需要使用 Tacotron2 文本到语音 进行文本到语音。
-
需要使用
torchaudio.kaldi_io
模块。
兼容性矩阵¶
TorchAudio 的官方二进制发行版包含用 C++ 编写的扩展模块,这些模块与特定版本的 PyTorch 链接。
不同版本的 TorchAudio 和 PyTorch 不能一起使用。请参阅下表以了解匹配的版本。
|
|
|
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|