Start Locally
选择您的偏好并运行安装命令。 Stable 代表当前经过测试和支持的 PyTorch 版本,适合大多数用户。如果您想要最新的、尚未完全测试和支持的每日构建版本, 可以选择 Preview。在安装之前,请确保您已经满足下面的先决条件(例如,numpy),这取决于您的包管理器。我们推荐使用 Anaconda 作为包管理器,因为它会安装所有依赖项。 您也可以安装以前版本的 PyTorch。请注意,LibTorch 仅适用于 C++。
注意: 最新PyTorch版本需配套使用Python 3.8或更高版本
在 macOS 上安装
PyTorch 可以在 macOS 上安装和使用。根据您的系统和 GPU 功能,您在 Mac 上使用 PyTorch 的体验可能在处理时间方面有所不同。
先决条件
macOS 版本
PyTorch 支持 macOS 10.15(Catalina)或更高版本。
Python
建议您使用 Python 3.8 - 3.11。 您可以通过 Anaconda 包管理器(见下文)、Homebrew 或 Python 官网安装 Python。
In one of the upcoming PyTorch releases, support for Python 3.8 will be deprecated.
包管理器
要安装 PyTorch 二进制文件,您需要使用两种受支持的包管理器之一:Anaconda 或 pip。推荐使用 Anaconda 作为包管理器,因为它将在一个沙盒安装中提供所有 PyTorch 依赖项,包括 Python。
Anaconda
要安装 Anaconda,您可以下载图形安装程序或使用命令行安装程序。如果您使用命令行安装程序,可以右键单击安装程序链接,选择”复制链接地址”,或在 Intel Mac 上使用以下命令:
# The version of Anaconda may be different depending on when you are installing`
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh
sh Miniconda3-latest-MacOSX-x86_64.sh
# and follow the prompts. The defaults are generally good.`
或在 M1 Mac 上使用以下命令:
# The version of Anaconda may be different depending on when you are installing`
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh
sh Miniconda3-latest-MacOSX-arm64.sh
# and follow the prompts. The defaults are generally good.`
pip
Python 3
如果您通过 Homebrew 或 Python 官网安装了 Python,pip 已随之安装。如果您安装了 Python 3.x,那么您将使用 pip3 命令。
提示:如果您想只使用 pip 命令,而不是 pip3,您可以将 pip 符号链接到 pip3 二进制文件。
Installation
Anaconda
要通过 Anaconda 安装 PyTorch,请使用以下 conda 命令:
conda install pytorch torchvision -c pytorch
pip
要通过 pip 安装 PyTorch,请根据您的 Python 版本使用以下两个命令之一:
# Python 3.x
pip3 install torch torchvision
Verification
为确保 PyTorch 安装正确,我们可以通过运行 PyTorch 示例代码来验证安装。这里我们将构造一个随机初始化的张量。
import torch
x = torch.rand(5, 3)
print(x)
输出应该类似于:
tensor([[0.3380, 0.3845, 0.3217],
[0.8337, 0.9050, 0.2650],
[0.2979, 0.7141, 0.9069],
[0.1449, 0.1132, 0.1375],
[0.4675, 0.3947, 0.1426]])
源代码构建
对于大多数 PyTorch 用户来说,通过包管理器安装预构建的二进制文件将提供最佳体验。但是,有时您可能想安装最新的 PyTorch 代码,无论是为了测试还是实际开发 PyTorch 核心。要安装最新的 PyTorch 代码,您需要从源代码构建PyTorch。
先决条件
- [可选] 安装 Anaconda
- 按照此处描述的步骤操作: https://github.com/pytorch/pytorch#from-source
您可以按照上述方法验证安装结果
在 Linux 上安装
PyTorch 可以在各种 Linux 发行版上安装和使用。根据您的系统和计算需求,您在 Linux 上使用 PyTorch 的体验可能在处理时间方面有所不同。建议(但不是必需)您的 Linux 系统有 NVIDIA 或 AMD GPU,以便充分利用 PyTorch 的 CUDA 支持 或 ROCm 支持。
先决条件
支持的 Linux 发行版
PyTorch 支持使用 glibc >= v2.17 的 Linux 发行版,包括以下:
- Arch Linux,最低版本 2012-07-15
- CentOS,最低版本 7.3-1611
- Debian,最低版本 8.0
- Fedora,最低版本 24
- Mint,最低版本 14
- OpenSUSE,最低版本 42.1
- PCLinuxOS,最低版本 2014.7
- Slackware,最低版本 14.2
- Ubuntu,最低版本 13.04
这里的安装说明通常适用于所有支持的 Linux 发行版。一个例外是您的发行版可能支持
yum
而不是apt
。所示的具体示例是在 Ubuntu 18.04 机器上运行的。
Python
Python 3.8-3.11 通常默认安装在我们支持的任何 Linux 发行版上,这符合我们的建议。
提示:默认情况下,您必须使用命令
python3
来运行 Python。如果您想只使用命令python
,而不是python3
,您可以将python
符号链接到python3
二进制文件。
但是,如果您想安装另一个版本,有多种方法:
- APT
- Python website
如果您决定使用 APT,可以运行以下命令来安装:
sudo apt install python
如果您使用 Anaconda 安装 PyTorch,它将安装一个沙盒版本的 Python,用于运行 PyTorch 应用程序。
包管理器
要安装 PyTorch 二进制文件,您需要使用两个支持的包管理器之一:Anaconda 或 pip 。推荐使用 Anaconda 作为包管理器,因为它将在一个沙盒安装中提供所有 PyTorch 依赖项,包括 Python。
Anaconda
要安装 Anaconda,您将使用 命令行安装程序 。右键单击 64 位安装程序链接,选择 复制链接地址
,然后使用以下命令:
# The version of Anaconda may be different depending on when you are installing`
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
sh Miniconda3-latest-Linux-x86_64.sh
# and follow the prompts. The defaults are generally good.`
您可能需要打开一个新的终端或重新加载
~/.bashrc
以获得对conda
命令的访问权限。
pip
Python 3
虽然 Python 3.x 默认安装在 Linux 上,但 pip
默认不安装。
sudo apt install python3-pip
提示:如果您想只使用命令
pip
,而不是pip3
,您可以将pip
符号链接到pip3
二进制文件。
安装
Anaconda
无 CUDA/ROCm
如果您通过 Anaconda 安装 PyTorch,并且没有 CUDA-capable or ROCm-capable ,或不需要 CUDA/ROCm(即 GPU 支持),在上面的选择器中,选择操作系统:Linux,包:Conda,语言:Python 和计算平台:CPU。 然后,运行向您显示的命令。
有 CUDA
如果您通过 Anaconda 安装 PyTorch,并且有 CUDA-capable 系统,在上面的选择器中,选择操作系统:Linux,包:Conda 和适合您机器的 CUDA 版本。通常,最新的 CUDA 版本更好。 然后,运行向您显示的命令。
有 ROCm
目前不支持通过 Anaconda 安装带 ROCm 的 PyTorch。请改用 pip。
pip
No CUDA
如果您通过 pip 安装 PyTorch,并且没有 CUDA-capable 或 ROCm-capable 系统,或不需要 CUDA/ROCm(即 GPU 支持),在上面的选择器中,选择操作系统:Linux,包:Pip,语言:Python 和计算平台:CPU。 然后,运行向您显示的命令。
With CUDA
如果您通过 pip 安装 PyTorch,并且有 CUDA-capable 系统,在上面的选择器中,选择操作系统:Linux,包:Pip,语言:Python 和适合您机器的 CUDA 版本。通常,最新的 CUDA 版本更好。 然后,运行向您显示的命令。
With ROCm
如果您通过 pip 安装 PyTorch,并且有 ROCm-capable 系统,在上面的选择器中,选择操作系统:Linux,包:Pip,语言:Python 和支持的 ROCm 版本。 然后,运行向您显示的命令。
Verification
为确保 PyTorch 安装正确,我们可以通过运行示例 PyTorch 代码来验证安装。这里我们将构造一个随机初始化的张量。
import torch
x = torch.rand(5, 3)
print(x)
输出应该类似于:
tensor([[0.3380, 0.3845, 0.3217],
[0.8337, 0.9050, 0.2650],
[0.2979, 0.7141, 0.9069],
[0.1449, 0.1132, 0.1375],
[0.4675, 0.3947, 0.1426]])
此外,要检查您的 GPU 驱动程序和 CUDA/ROCm 是否已启用并可被 PyTorch 访问,运行以下命令以返回 GPU 驱动程序是否已启用(PyTorch 的 ROCm 构建在 Python API 级别 link 使用相同的语义 链接,因此以下命令也应适用于 ROCm):
import torch
torch.cuda.is_available()
源代码构建
对于大多数 PyTorch 用户来说,通过包管理器从预构建的二进制文件安装将提供最佳体验。但是,有时您可能想安装最新的 PyTorch 代码,无论是为了测试还是实际开发 PyTorch 核心。要安装最新的 PyTorch 代码,您需要从 源代码构建 PyTorch 。
先决条件
-
安装 Anaconda 或 Pip 如果您需要构建带 GPU 支持的 PyTorch
a. 对于 NVIDIA GPU,如果您的机器有 CUDA 兼容 GPU,请安装 CUDA 。 b. 对于 AMD GPU,如果您的机器有 ROCm 兼容 GPU,请安装 ROCm。
按照此处描述的步骤操作:https://github.com/pytorch/pytorch#from-source
在 Windows 上安装
PyTorch 可以在各种 Windows 发行版上安装和使用。根据您的系统和计算需求,您在 Windows 上使用 PyTorch 的体验可能在处理时间方面有所不同。建议(但不是必需)您的 Windows 系统有一个 NVIDIA GPU,以便充分利用 PyTorch 的 CUDA 支持。
先决条件
支持的 Windows 发行版
PyTorch 支持以下 Windows 发行版:
- Windows 7 及更高版本;推荐 Windows 10 或更高版本。
- Windows Server 2008 r2 及更高版本
这里的安装说明通常适用于所有支持的 Windows 发行版。具体示例将在 Windows 10 企业版机器上运行。
Python
目前,Windows 上的 PyTorch 仅支持 Python 3.8-3.11;不支持 Python 2.x。
由于 Windows 默认不安装 Python,有多种方法可以安装 Python:
如果您使用 Anaconda 安装 PyTorch,它将安装一个沙盒版本的 Python,用于运行 PyTorch 应用程序。
如果您决定使用 Chocolatey,并且尚未安装 Chocolatey,请确保以管理员身份运行命令提示符。
对于基于 Chocolatey 的安装,在管理员命令提示符中运行以下命令:
choco install python
包管理器
要安装 PyTorch 二进制文件,您需要使用至少两个支持的包管理器中的一个:Anaconda 或 pip 。推荐使用 Anaconda 作为包管理器,因为它将在一个沙盒安装中提供所有 PyTorch 依赖项,包括 Python 和 pip。
Anaconda
要安装 Anaconda,您将使用 安装程序 安装 PyTorch 3.x。点击安装程序链接并选择 运行
。Anaconda 将下载,并向您显示安装程序提示。默认选项通常是合理的。
pip
如果您通过 上面 推荐的任何方式安装了 Python,pip 已经为您安装好了。
安装
Anaconda
要使用 Anaconda 安装 PyTorch,您需要通过 Start | Anaconda3 | Anaconda Prompt
打开 Anaconda。
无 CUDA
如果要通过 Anaconda 安装 PyTorch,并且没有 CUDA-capable 系统或不需要 CUDA,在上面的选择器中,选择 OS: Windows,Package: Conda 和 CUDA: None。 然后,运行向您显示的命令。
有 CUDA
如果要通过 Anaconda 安装 PyTorch,并且您确实有 CUDA-capable 系统,在上面的选择器中,选择 OS: Windows,Package: Conda 和适合您机器的 CUDA 版本。通常,最新的 CUDA 版本更好。 然后,运行向您显示的命令。
pip
无 CUDA
如果要通过 pip 安装 PyTorch,并且没有 CUDA-capable 系统或不需要 CUDA,在上面的选择器中,选择 OS: Windows,Package: Pip 和 CUDA: None。 然后,运行向您显示的命令。
有 CUDA
如果要通过 pip 安装 PyTorch,并且您确实有 CUDA-capable 系统,在上面的选择器中,选择 OS: Windows,Package: Pip 和适合您机器的 CUDA 版本。通常,最新的 CUDA 版本更好。 然后,运行向您显示的命令。
验证
为了确保 PyTorch 安装正确,我们可以通过运行示例 PyTorch 代码来验证安装。这里我们将构造一个随机初始化的张量。
在命令行中,输入:
python
然后输入以下代码:
import torch
x = torch.rand(5, 3)
print(x)
输出应该类似于:
tensor([[0.3380, 0.3845, 0.3217],
[0.8337, 0.9050, 0.2650],
[0.2979, 0.7141, 0.9069],
[0.1449, 0.1132, 0.1375],
[0.4675, 0.3947, 0.1426]])
此外,要检查您的 GPU 驱动程序和 CUDA 是否已启用并可被 PyTorch 访问,运行以下命令以返回 CUDA 驱动程序是否已启用:
import torch
torch.cuda.is_available()
源代码构建
对于大多数 PyTorch 用户来说,通过包管理器从预构建的二进制文件安装将提供最佳体验。但是,有时您可能想安装最新的 PyTorch 代码,无论是为了测试还是实际开发 PyTorch 核心。要安装最新的 PyTorch 代码,您需要从 源代码构建 PyTorch 。
先决条件
- 安装 Anaconda
- 安装 CUDA, 如果机器有 CUDA-enabled GPU.
- 如果您想在 Windows 上构建,还需要带有 MSVC 工具集的 Visual Studio 和 NVTX。这些依赖项的确切要求可以在查看 这里 。
- 按照这里描述的步骤操作:https://github.com/pytorch/pytorch#from-source
您可以按照 上面 描述的方法验证安装。