本地启动
选择您的偏好并运行安装命令。稳定版(Stable)代表当前经过测试和支持的 PyTorch 版本,适合大多数用户。如果您希望使用最新的、未经充分测试和支持的每日构建版本,可以选择预览版(Preview)。请确保根据您的包管理器满足以下先决条件(例如 numpy)。您也可以安装以前版本的 PyTorch。请注意,LibTorch 仅支持 C++。
注意:最新稳定版 PyTorch 需要 Python 3.10 或更高版本。
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
在 macOS 上安装
PyTorch 可以在 macOS 上安装并使用。根据您的系统和 GPU 能力,PyTorch 在 macOS 上的处理时间体验可能会有所不同。
先决条件
macOS 版本
PyTorch 支持 macOS 10.15 (Catalina) 或更高版本。
Python
建议使用 Python 3.10 - 3.14。您可以通过 Homebrew 或 Python 官网 安装 Python。
包管理器
要安装 PyTorch 二进制文件,您需要使用支持的包管理器:pip。
pip
Python 3
如果您通过 Homebrew 或 Python 官网安装了 Python,pip 也会随之安装。如果您安装的是 Python 3.x,则需要使用 pip3 命令。
提示:如果您只想使用
pip命令而不是pip3,您可以将pip符号链接到pip3二进制文件。
安装
pip
要通过 pip 安装 PyTorch,请根据您的 Python 版本使用以下命令
# Python 3.x
pip3 install torch torchvision
验证
为了确保正确安装 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。
先决条件
- [可选] 安装 pip
- 遵循此处描述的步骤:https://github.com/pytorch/pytorch#from-source
您可以按照上述方法验证安装。
在 Linux 上安装
PyTorch 可以在各种 Linux 发行版上安装并使用。根据您的系统和计算要求,PyTorch 在 Linux 上的处理时间体验可能会有所不同。建议(但不是必须)您的 Linux 系统拥有 NVIDIA 或 AMD GPU,以便充分利用 PyTorch 的 CUDA 支持 或 ROCm 支持。
先决条件
支持的 Linux 发行版
PyTorch 支持使用 glibc >= v2.28 的 Linux 发行版,包括以下版本
- Arch Linux, 最低版本 2020.01.22
- CentOS, 最低版本 8
- Debian, 最低版本 10.0
- Fedora, 最低版本 24
- Mint, 最低版本 20
- OpenSUSE, 最低版本 15
- PCLinuxOS, 最低版本 2014.7
- Slackware, 最低版本 14.2
- Ubuntu, 最低版本 20.04 (请注意,20.04 已停止维护 EOL)
此处的安装说明通常适用于所有受支持的 Linux 发行版。一个典型的区别是您的发行版可能支持
yum而不是apt。所示的具体示例是在 Ubuntu 18.04 机器上运行的。
Python
Python 3.10-3.14 通常在我们的任何受支持的 Linux 发行版上默认安装,符合我们的建议。
提示:默认情况下,您必须使用
python3命令来运行 Python。如果您只想使用python命令而不是python3,您可以将python符号链接到python3二进制文件。
但是,如果您想安装其他版本,有多种方法
- APT
- Python 官网
如果您决定使用 APT,可以运行以下命令进行安装
sudo apt install python
包管理器
要安装 PyTorch 二进制文件,您需要使用支持的包管理器:pip。
pip
Python 3
虽然 Python 3.x 在 Linux 上是默认安装的,但 pip 并非默认安装。
sudo apt install python3-pip
提示:如果您只想使用
pip命令而不是pip3,您可以将pip符号链接到pip3二进制文件。
安装
pip
无 CUDA
若要通过 pip 安装 PyTorch,且没有 CUDA 兼容或 ROCm 兼容的系统,或者不需要 CUDA/ROCm(即 GPU 支持),请在上面的选择器中选择 OS: Linux,Package: Pip,Language: Python,Compute Platform: CPU。然后运行为您提供的命令。
带 CUDA
若要通过 pip 安装 PyTorch 且拥有 CUDA 兼容系统,请在上面的选择器中选择 OS: Linux,Package: Pip,Language: Python,以及适合您机器的 CUDA 版本。通常,最新的 CUDA 版本更好。然后运行为您提供的命令。
带 ROCm
若要通过 pip 安装 PyTorch 且拥有 ROCm 兼容系统,请在上面的选择器中选择 OS: Linux,Package: Pip,Language: Python,以及支持的 ROCm 版本。然后运行为您提供的命令。
验证
为了确保正确安装 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 级别使用相同的语义 链接,因此以下命令也适用于 ROCm)
import torch
torch.cuda.is_available()
从源码构建
对于大多数 PyTorch 用户来说,通过包管理器安装预编译的二进制文件是最好的体验。然而,有时您可能需要安装最前沿的 PyTorch 代码,用于测试或 PyTorch 核心开发。要安装最新的 PyTorch 代码,您需要从源码构建 PyTorch。
先决条件
- 安装 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 发行版上安装并使用。根据您的系统和计算要求,PyTorch 在 Windows 上的处理时间体验可能会有所不同。建议(但不是必须)您的 Windows 系统拥有 NVIDIA GPU,以便充分利用 PyTorch 的 CUDA 支持。
先决条件
支持的 Windows 发行版
PyTorch 支持以下 Windows 发行版
- Windows 7 及更高版本;建议使用 Windows 10 或更高版本。
- Windows Server 2008 r2 及更高版本
此处的安装说明通常适用于所有受支持的 Windows 发行版。所示的具体示例是在 Windows 10 企业版机器上运行的。
Python
目前,Windows 上的 PyTorch 仅支持 Python 3.10-3.14;不支持 Python 2.x。
由于 Windows 不会默认安装 Python,因此有多种安装方法
如果您决定使用 Chocolatey,且尚未安装,请确保以管理员身份运行命令提示符。
对于基于 Chocolatey 的安装,请在管理员命令提示符中运行以下命令
choco install python
包管理器
要安装 PyTorch 二进制文件,您需要使用支持的包管理器:pip。
pip
如果您通过上述任何推荐方式安装了 Python,pip 应该已经为您安装好了。
安装
pip
无 CUDA
若要通过 pip 安装 PyTorch,且没有 CUDA 兼容系统或不需要 CUDA,请在上面的选择器中选择 OS: Windows,Package: Pip,CUDA: None。然后运行为您提供的命令。
带 CUDA
若要通过 pip 安装 PyTorch 且拥有 CUDA 兼容系统,请在上面的选择器中选择 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。
先决条件
- 安装 pip
- 如果您的机器有 CUDA 兼容 GPU,请安装 CUDA。
- 如果您想在 Windows 上构建,还需要 Visual Studio(包含 MSVC 工具集)和 NVTX。这些依赖项的具体要求可以在此处找到。
- 遵循此处描述的步骤:https://github.com/pytorch/pytorch#from-source
您可以按照上述方法验证安装。