捷徑

    從本機開始

    選擇您的偏好設定並執行安裝命令。Stable 代表目前經過最多測試和支援的 PyTorch 版本。這應該適合許多使用者。如果您想要最新的、未完全測試和支援的、每晚產生的版本,則可以使用 Preview。請確保您已滿足以下先決條件(例如,numpy),具體取決於您的套件管理器。您也可以安裝先前的 PyTorch 版本。請注意,LibTorch 僅適用於 C++。

    注意:最新的 PyTorch 需要 Python 3.9 或更高版本。

    PyTorch 建置
    您的作業系統
    套件
    語言
    運算平台
    執行此命令
    PyTorch 建置
    Stable (1.13.0)
    Preview (Nightly)
    您的作業系統
    Linux
    Mac
    Windows
    套件
    Conda
    Pip
    LibTorch
    Source
    語言
    Python
    C++ / Java
    運算平台
    CUDA 11.8
    CUDA 12.1
    CUDA 12.4
    ROCm 5.2
    CPU
    執行此命令
    conda install pytorch torchvision -c pytorch


    在 macOS 上安裝

    PyTorch 可以在 macOS 上安裝和使用。根據您的系統和 GPU 功能,您在使用 Mac 上的 PyTorch 時,處理時間可能會有所不同。

    先決條件

    macOS 版本

    PyTorch 支援 macOS 10.15 (Catalina) 或更高版本。

    Python

    建議您使用 Python 3.9 - 3.12。您可以透過 Anaconda 套件管理器(請參閱下方)、HomebrewPython 網站安裝 Python。

    套件管理器

    要安裝 PyTorch 二進位檔案,您需要使用兩個支援的套件管理器之一:pipAnaconda

    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

    先決條件

    1. [可選] 安裝 Anaconda
    2. 請按照此處描述的步驟進行: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 發行版,包括以下

    此處的安裝說明通常適用於所有支援的 Linux 發行版。例如,您的發行版可能支援 yum 而不是 apt。所示的特定範例是在 Ubuntu 18.04 機器上執行的。

    Python

    Python 3.9-3.12 通常預設安裝在我們任何支援的 Linux 發行版上,這符合我們的建議。

    提示:預設情況下,您必須使用命令 python3 來執行 Python。如果您只想使用命令 python,而不是 python3,您可以將 python 符號連結到 python3 二進位檔。

    但是,如果您想安裝另一個版本,有多種方法

    如果您決定使用 APT,您可以執行以下命令來安裝它

    sudo apt install python
    

    如果您使用 Anaconda 安裝 PyTorch,它將安裝一個沙盒版本的 Python,用於執行 PyTorch 應用程式。

    套件管理器

    要安裝 PyTorch 二進位檔,您需要使用兩種支援的套件管理器之一:Anacondapip。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

    先決條件

    1. 安裝 AnacondaPip
    2. 如果您需要建置支援 GPU 的 PyTorch,a. 對於 NVIDIA GPU,如果您的機器具有 支援 CUDA 的 GPU,請安裝 CUDA。b. 對於 AMD GPU,如果您的機器具有 支援 ROCm 的 GPU,請安裝 ROCm
    3. 請按照此處描述的步驟進行:https://github.com/pytorch/pytorch#from-source

    您可以按照上方所述驗證安裝。

    在 Windows 上安裝

    PyTorch 可以在各種 Windows 發行版上安裝和使用。根據您的系統和計算需求,您在使用 Windows 上的 PyTorch 時,處理時間可能會有所不同。建議(但非必要)您的 Windows 系統擁有 NVIDIA GPU,以便充分利用 PyTorch 的 CUDA 支援

    先決條件

    支援的 Windows 發行版

    PyTorch 支援以下 Windows 發行版

    此處的安裝說明通常適用於所有支援的 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 二進位檔,您至少需要使用兩種支援的套件管理器之一:Anacondapip。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

    先決條件

    1. 安裝 Anaconda
    2. 安裝 CUDA,如果您的機器有 支援 CUDA 的 GPU
    3. 如果您想在 Windows 上建置,也需要具有 MSVC 工具集的 Visual Studio 和 NVTX。 這些依賴項的確切要求可以在這裡找到。
    4. 請按照此處描述的步驟進行:https://github.com/pytorch/pytorch#from-source

    您可以依照上述說明驗證安裝。