From 465a1cfe2e8a49cb72df3bb33e78bf1572e13e51 Mon Sep 17 00:00:00 2001 From: ZhaoqiongZ <106125927+ZhaoqiongZ@users.noreply.github.com> Date: Fri, 17 Jan 2025 06:31:40 +0000 Subject: [PATCH] update get start xpu (#143183) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Support new Intel client GPU on Windows [Intel® Arc™ B-Series graphics](https://www.intel.com/content/www/us/en/products/docs/discrete-gpus/arc/desktop/b-series/overview.html) and [Intel® Core™ Ultra Series 2 with Intel® Arc™ Graphics](https://www.intel.com/content/www/us/en/products/details/processors/core-ultra.html) - Support vision/audio prebuilt wheels on Windows Pull Request resolved: https://github.com/pytorch/pytorch/pull/143183 Approved by: https://github.com/EikanWang, https://github.com/leslie-fang-intel, https://github.com/atalman, https://github.com/malfet Co-authored-by: Nikita Shulga <2453524+malfet@users.noreply.github.com> --- docs/source/notes/get_start_xpu.rst | 52 +++++++++-------------------- 1 file changed, 16 insertions(+), 36 deletions(-) diff --git a/docs/source/notes/get_start_xpu.rst b/docs/source/notes/get_start_xpu.rst index 7742751d543..dde7e134645 100644 --- a/docs/source/notes/get_start_xpu.rst +++ b/docs/source/notes/get_start_xpu.rst @@ -8,23 +8,24 @@ Hardware Prerequisite :widths: 50 50 :header-rows: 1 - * - Validated Hardware - - Supported OS - * - Intel® Data Center GPU Max Series - - Linux - * - Intel Client GPU - - Windows/Linux + * - Supported OS + - Validated Hardware + * - Linux + - Intel® Client GPUs / Intel® Data Center GPU Max Series + * - Windows + - Intel® Client GPUs + * - WSL2 (experimental feature) + - Intel® Client GPUs -Intel GPUs support (Prototype) is ready in PyTorch* 2.5 for Intel® Data Center GPU Max Series and Intel® Client GPUs on both Linux and Windows, which brings Intel GPUs and the SYCL* software stack into the official PyTorch stack with consistent user experience to embrace more AI application scenarios. +Intel GPUs support (Prototype) is ready in PyTorch* 2.6 for Intel® Client GPUs and Intel® Data Center GPU Max Series on both Linux and Windows, which brings Intel GPUs and the SYCL* software stack into the official PyTorch stack with consistent user experience to embrace more AI application scenarios. Software Prerequisite --------------------- -Visit `PyTorch Installation Prerequisites for Intel GPUs `_ for more detailed information regarding: +To use PyTorch on Intel GPUs, you need to install the Intel GPUs driver first. For installation guide, visit `Intel GPUs Driver Installation `_. + +Intel GPU Drivers are sufficient for binary installation, while building from source requires both Intel GPU Drivers and Intel® Deep Learning Essentials. Please refer to `PyTorch Installation Prerequisites for Intel GPUs `_ for more information. -#. Intel GPU driver installation -#. Intel support package installation -#. Environment setup Installation ------------ @@ -32,11 +33,7 @@ Installation Binaries ^^^^^^^^ -Platform Linux -"""""""""""""" - - -Now we have all the required packages installed and environment activated. Use the following commands to install ``pytorch``, ``torchvision``, ``torchaudio`` on Linux. +Now that we have `Intel GPU Driver `_ installed, use the following commands to install ``pytorch``, ``torchvision``, ``torchaudio`` on Linux. For preview wheels @@ -50,26 +47,13 @@ For nightly wheels pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu -Platform Windows -"""""""""""""""" -Now we have all the required packages installed and environment activated. Use the following commands to install ``pytorch`` on Windows, build from source for ``torchvision`` and ``torchaudio``. - -For preview wheels - -.. code-block:: - - pip3 install torch --index-url https://download.pytorch.org/whl/test/xpu - -For nightly wheels - -.. code-block:: - - pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu From Source ^^^^^^^^^^^ +Now that we have `Intel GPU Driver and Intel® Deep Learning Essentials `_ installed. Follow guides to build ``pytorch``, ``torchvision``, ``torchaudio`` from source. + Build from source for ``torch`` refer to `PyTorch Installation Build from source `_. Build from source for ``torchvision`` refer to `Torchvision Installation Build from source `_. @@ -86,11 +70,7 @@ To check if your Intel GPU is available, you would typically use the following c import torch torch.xpu.is_available() # torch.xpu is the API for Intel GPU support -If the output is ``False``, double check following steps below. - -#. Intel GPU driver installation -#. Intel support package installation -#. Environment setup +If the output is ``False``, double check driver installation for Intel GPUs. Minimum Code Change -------------------