從本機開始
選擇您的偏好設定並執行安裝命令。Stable 代表目前經過最多測試和支援的 PyTorch 版本。這應該適合許多使用者。如果您想要最新的、未完全測試和支援的、每晚產生的版本,則可以使用 Preview。請確保您已滿足以下先決條件(例如,numpy),具體取決於您的套件管理器。您也可以安裝先前的 PyTorch 版本。請注意,LibTorch 僅適用於 C++。
注意:最新的 PyTorch 需要 Python 3.9 或更高版本。
在 macOS 上安裝
PyTorch 可以在 macOS 上安裝和使用。根據您的系統和 GPU 功能,您在使用 Mac 上的 PyTorch 時,處理時間可能會有所不同。
先決條件
macOS 版本
PyTorch 支援 macOS 10.15 (Catalina) 或更高版本。
Python
建議您使用 Python 3.9 - 3.12。您可以透過 Anaconda 套件管理器(請參閱下方)、Homebrew 或 Python 網站安裝 Python。
套件管理器
要安裝 PyTorch 二進位檔案,您需要使用兩個支援的套件管理器之一:pip 或 Anaconda。
Anaconda
要安裝 Anaconda,您可以下載圖形化安裝程式或使用命令列安裝程式。如果您使用命令列安裝程式,您可以右鍵點擊安裝程式連結,選擇 Copy Link Address
,或在配備 Apple 晶片的 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
二進位檔案。
安裝
Anaconda
要透過 Anaconda 安裝 PyTorch,請使用以下 conda 命令
conda install pytorch torchvision -c pytorch
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。
先決條件
- [可選] 安裝 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.9-3.12 通常預設安裝在我們任何支援的 Linux 發行版上,這符合我們的建議。
提示:預設情況下,您必須使用命令
python3
來執行 Python。如果您只想使用命令python
,而不是python3
,您可以將python
符號連結到python3
二進位檔。
但是,如果您想安裝另一個版本,有多種方法
- APT
- Python 網站
如果您決定使用 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 或 支援 ROCm 的系統,或者不需要 CUDA/ROCm(即 GPU 支援),請在上面的選擇器中,選擇 OS:Linux,Package:Conda,Language:Python 和 Compute Platform:CPU。然後,執行呈現給您的命令。
使用 CUDA
要透過 Anaconda 安裝 PyTorch,並且您確實擁有 支援 CUDA 的系統,請在上面的選擇器中,選擇 OS:Linux,Package:Conda 和適合您機器的 CUDA 版本。通常,最新的 CUDA 版本更好。然後,執行呈現給您的命令。
使用 ROCm
目前 ROCm 不支援透過 Anaconda 安裝 PyTorch。請改用 pip。
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。
先決條件
- 安裝 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 Enterprise 機器上執行
Python
目前,Windows 上的 PyTorch 僅支援 Python 3.9-3.12;不支援 Python 2.x。
由於它未預設安裝在 Windows 上,因此有多種安裝 Python 的方法
如果您使用 Anaconda 安裝 PyTorch,它將安裝一個沙盒版本的 Python,用於執行 PyTorch 應用程式。
如果您決定使用 Chocolatey,並且尚未安裝 Chocolatey,請確保您以管理員身份執行命令提示字元。
對於基於 Chocolatey 的安裝,請在管理命令提示字元中執行以下命令
choco install python
套件管理器
要安裝 PyTorch 二進位檔,您至少需要使用兩種支援的套件管理器之一:Anaconda 和 pip。Anaconda 是推薦的套件管理器,因為它將在一個沙盒安裝中提供所有 PyTorch 依賴項,包括 Python 和 pip
。
Anaconda
若要安裝 Anaconda,您將使用適用於 PyTorch 3.x 的 64 位元圖形化安裝程式。點擊安裝程式連結並選擇 執行
。Anaconda 將會下載,並向您顯示安裝程式提示。預設選項通常是合理的。
pip
如果您已透過上述推薦的任何方式安裝 Python,則 pip 應該已經為您安裝好了。
安裝
Anaconda
若要透過 Anaconda 安裝 PyTorch,您需要透過 開始 | Anaconda3 | Anaconda Prompt
開啟 Anaconda prompt。
無 CUDA
若要透過 Anaconda 安裝 PyTorch,且您的系統沒有 支援 CUDA 的硬體,或不需要 CUDA,請在上述選擇器中選擇「OS: Windows」、「Package: Conda」和「CUDA: None」。然後,執行顯示給您的指令。
使用 CUDA
若要透過 Anaconda 安裝 PyTorch,且您有 支援 CUDA 的硬體,請在上述選擇器中選擇「OS: Windows」、「Package: Conda」和適用於您機器的 CUDA 版本。通常,最新的 CUDA 版本會比較好。然後,執行顯示給您的指令。
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。
先決條件
- 安裝 Anaconda
- 安裝 CUDA,如果您的機器有 支援 CUDA 的 GPU。
- 如果您想在 Windows 上建置,也需要具有 MSVC 工具集的 Visual Studio 和 NVTX。 這些依賴項的確切要求可以在這裡找到。
- 請按照此處描述的步驟進行:https://github.com/pytorch/pytorch#from-source
您可以依照上述說明驗證安裝。