Add ROCm 7.9.0 documentation

Add release notes

Add install instructions

Add PyTorch + ComfyUI instructions

Add custom selector directives

Add JS and CSS for selector

Add custom icon directive and utils

Clean up conf.py

docs/install/includes/1_rhel-10.0-tar-prerequisites.md

@@ -0,0 +1,21 @@
+1. Register your Enterprise Linux.
+
+   ```bash
+   subscription-manager register --username <username> --password <password>
+   ```
+
+2. Update your Enterprise Linux.
+
+   ```bash
+   sudo dnf update --releasever=10.0 --exclude=\*release\*
+   ```
+
+3. Configure permissions for GPU access.
+
+   ```bash
+   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
+   ```
+
+   ```{note}
+   To apply all settings, reboot your system.
+   ```

docs/install/includes/1_rhel-10.0-wheel-prerequisites.md

@@ -0,0 +1,27 @@
+1. Register your Enterprise Linux.
+
+   ```bash
+   subscription-manager register --username <username> --password <password>
+   ```
+
+2. Update your Enterprise Linux.
+
+   ```bash
+   sudo dnf update --releasever=10.0 --exclude=\*release\*
+   ```
+
+3. Install Python 3.12 or 3.13.
+
+   ```bash
+   sudo dnf install python3.12 python3.12-pip
+   ```
+
+4. Configure permissions for GPU access.
+
+   ```bash
+   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
+   ```
+
+   ```{note}
+   To apply all settings, reboot your system.
+   ```

docs/install/includes/1_rhel-9.6-tar-prerequisites.md

@@ -0,0 +1,22 @@
+1. Register your Enterprise Linux.
+
+   ```bash
+   subscription-manager register --username <username> --password <password>
+   sudo subscription-manager attach --auto
+   ```
+
+2. Update your Enterprise Linux.
+
+   ```bash
+   sudo dnf update --releasever=9.6 --exclude=\*release\*
+   ```
+
+3. Configure permissions for GPU access.
+
+   ```bash
+   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
+   ```
+
+   ```{note}
+   To apply all settings, reboot your system.
+   ```

docs/install/includes/1_rhel-9.6-wheel-prerequisites.md

@@ -0,0 +1,28 @@
+1. Register your Enterprise Linux.
+
+   ```bash
+   subscription-manager register --username <username> --password <password>
+   sudo subscription-manager attach --auto
+   ```
+
+2. Update your Enterprise Linux.
+
+   ```bash
+   sudo dnf update --releasever=9.6 --exclude=\*release\*
+   ```
+
+3. Install Python 3.11, 3.12 or 3.13.
+
+   ```bash
+   sudo dnf install python3.11 python3.11-pip
+   ```
+
+4. Configure permissions for GPU access.
+
+   ```bash
+   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
+   ```
+
+   ```{note}
+   To apply all settings, reboot your system.
+   ```

docs/install/includes/1_ubuntu-22.04-wheel-prerequisites.md

@@ -0,0 +1,15 @@
+1. Install Python 3.11.
+
+   ```bash
+   sudo apt install python3.11 python3.11-venv
+   ```
+
+2. Configure permissions for GPU access.
+
+   ```bash
+   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
+   ```
+
+   ```{note}
+   To apply all settings, reboot your system.
+   ```

docs/install/includes/1_ubuntu-24.04-wheel-prerequisites.md

@@ -0,0 +1,15 @@
+1. Install Python 3.12 or 3.13.
+
+   ```bash
+   sudo apt install python3.12 python3.12-venv
+   ```
+
+2. Configure permissions for GPU access.
+
+   ```bash
+   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
+   ```
+
+   ```{note}
+   To apply all settings, reboot your system.
+   ```

docs/install/includes/1_ubuntu-tar-prerequisites.md

@@ -0,0 +1,9 @@
+Configure permissions for GPU access.
+
+```bash
+sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
+```
+
+```{note}
+To apply all settings, reboot your system.
+```

docs/install/includes/1_windows-tar-prerequisites.md

@@ -0,0 +1,6 @@
+1. Remove any existing HIP SDK installations and other
+   conflicting AMD graphics software.
+
+2. Install the [Adrenalin Driver version
+   25.9.2](https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-9-2.html).
+   For instructions, see [Install AMD Software: Adrenalin Edition](https://www.amd.com/en/resources/support-articles/faqs/RSX2-INSTALL.html).

docs/install/includes/1_windows-wheel-prerequisites.md

@@ -0,0 +1,8 @@
+1. Remove any existing HIP SDK installations and other
+   conflicting AMD graphics software.
+
+2. Install the [Adrenalin Driver version
+   25.9.2](https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-9-2.html).
+   For instructions, see [Install AMD Software: Adrenalin Edition](https://www.amd.com/en/resources/support-articles/faqs/RSX2-INSTALL.html).
+
+3. Install a supported Python version: 3.11, 3.12, or 3.13.

docs/install/includes/2_rhel-instinct-install-kmd.md

@@ -0,0 +1,6 @@
+For information about driver compatibility, see the {doc}`compatibility-matrix`.
+
+For information about the AMD GPU driver installation, see the
+[RHEL native
+installation](https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-rhel.html)
+in the AMD Instinct Data Center GPU Documentation.

docs/install/includes/2_ubuntu-instinct-install-kmd.md

@@ -0,0 +1,6 @@
+For information about driver compatibility, see the {doc}`compatibility-matrix`.
+
+For information about the AMD GPU driver installation, see the
+[Ubuntu native
+installation](https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-ubuntu.html)
+in the AMD Instinct Data Center GPU Documentation.

docs/install/includes/3_tar-gfx1151-install-rocm.md

@@ -0,0 +1,20 @@
+1. Create the installation directory. For example:
+
+   ```bash
+   mkdir therock-tarball && cd therock-tarball
+   ```
+
+   ```{note}
+   Subsequent commands assume you're working with the
+   `therock-tarball` directory.
+   If you choose a different directory name, adjust the
+   subsequent commands accordingly.
+   ```
+
+2. Download and unpack the tarball.
+
+   ```bash
+   wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1151-7.9.0rc1.tar.gz
+   mkdir install
+   tar -xf *.tar.gz -C install
+   ```

docs/install/includes/3_tar-gfx942-install-rocm.md

@@ -0,0 +1,20 @@
+1. Create the installation directory. For example:
+
+   ```bash
+   mkdir therock-tarball && cd therock-tarball
+   ```
+
+   ```{note}
+   Subsequent commands assume you're working with the
+   `therock-tarball` directory.
+   If you choose a different directory name, adjust the
+   subsequent commands accordingly.
+   ```
+
+2. Download and unpack the tarball.
+
+   ```bash
+   wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx94X-dcgpu-7.9.0rc1.tar.gz
+   mkdir install
+   tar -xf *.tar.gz -C install
+   ```

docs/install/includes/3_tar-gfx950-install-rocm.md

@@ -0,0 +1,20 @@
+1. Create the installation directory. For example:
+
+   ```bash
+   mkdir therock-tarball && cd therock-tarball
+   ```
+
+   ```{note}
+   Subsequent commands assume you're working with the
+   `therock-tarball` directory.
+   If you choose a different directory name, adjust the
+   subsequent commands accordingly.
+   ```
+
+2. Download and unpack the tarball.
+
+   ```bash
+   wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx950-dcgpu-7.9.0rc1.tar.gz
+   mkdir install
+   tar -xf *.tar.gz -C install
+   ```

docs/install/includes/3_wheel-gfx1151-install-rocm.md

@@ -0,0 +1,12 @@
+1. Set up your Python virtual environment.
+
+   ```bash
+   python3.12 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+2. Install ROCm wheels packages.
+
+   ```bash
+   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "rocm[libraries,devel]"
+   ```

docs/install/includes/3_wheel-gfx942-install-rocm-py311.md

@@ -0,0 +1,12 @@
+1. Set up your Python virtual environment.
+
+   ```bash
+   python3.11 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+2. Install ROCm wheels packages.
+
+   ```bash
+   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
+   ```

docs/install/includes/3_wheel-gfx942-install-rocm.md

@@ -0,0 +1,12 @@
+1. Set up your Python virtual environment.
+
+   ```bash
+   python3.12 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+2. Install ROCm wheels packages.
+
+   ```bash
+   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
+   ```

docs/install/includes/3_wheel-gfx950-install-rocm-py311.md

@@ -0,0 +1,12 @@
+1. Set up your Python virtual environment.
+
+   ```bash
+   python3.11 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+2. Install ROCm wheels packages.
+
+   ```bash
+   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
+   ```

docs/install/includes/3_wheel-gfx950-install-rocm.md

@@ -0,0 +1,12 @@
+1. Set up your Python virtual environment.
+
+   ```bash
+   python3.12 -m venv .venv
+   source .venv/bin/activate
+   ```
+
+2. Install ROCm wheels packages.
+
+   ```bash
+   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
+   ```

docs/install/includes/3_windows-tar-install-rocm.md

@@ -0,0 +1,47 @@
+```{important}
+- Do not copy/replace the ROCm-SDK compiler and runtime DLLs to
+`System32` as this can cause conflicts.
+
+- Disable the following Windows security features as they
+  can interfere with ROCm functionality:
+
+  - Turn off WDAG (Windows Defender Application Guard)
+    - Control Panel > Programs > Programs and Features > Turn Windows features on or off > **Deselect** "Microsoft Defender Application Guard"
+  - Turn off SAC (Smart App Control)
+    - Settings > Privacy & security > Windows Security > App & browser control > Smart App Control settings > **Off**
+```
+
+1. Create the installation directory in `C:\TheRock\build`.
+
+   ```{note}
+   Subsequent commands assume you're working with the
+   `C:\TheRock\build` directory.
+   ```
+
+2. Download the tarball and extract the contents to
+   `C:\TheRock\build`.
+
+   - Download link: [https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.9.0rc1.tar.gz](https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.9.0rc1.tar.gz)
+
+3. Set the following environment variables using the command
+   prompt as an administrator:
+
+   ```bat
+   setx HIP_DEVICE_LIB_PATH “C:\TheRock\build\lib\llvm\amdgcn\bitcode” /M
+   setx HIP_PATH “C:\TheRock\build” /M
+   setx HIP_PLATFORM “amd” /M
+   setx LLVM_PATH “C:\TheRock\build\lib\llvm” /M
+   ```
+
+4. Add the following paths into PATH environment variable using your system settings GUI.
+
+   - `C:\TheRock\build\bin`
+
+   - `C:\TheRock\build\lib\llvm\bin`
+
+5. Open a new command prompt window for the environment variables to take effect. Run `set`
+   to see the list of active variables.
+
+   ```bat
+   set
+   ````

docs/install/includes/3_windows-wheel-install-rocm.md

@@ -0,0 +1,12 @@
+1. Set up your Python virtual environment.
+
+   ```bash
+   python3.12 -m venv .venv
+   .venv\Scripts\activate
+   ```
+
+2. Install ROCm wheels packages.
+
+   ```bash
+   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "rocm[libraries,devel]"
+   ```

docs/install/includes/4_linux-tar-post-install.md

@@ -0,0 +1,55 @@
+1. Configure ROCm PATH. Make sure you're in the `therock-tarball` directory before proceeding.
+
+   ```bash
+   export ROCM_PATH=$PWD
+   export PATH=$PATH:$ROCM_PATH/install/bin
+   ```
+
+2. Configure `LD_LIBRARY_PATH`.
+
+   ```bash
+   export LD_LIBRARY_PATH=$ROCM_PATH/install/lib
+   ```
+
+3. Verify the ROCm installation.
+
+   ```bash
+   rocminfo
+   amd-smi
+   ```
+
+   ```{eval-rst}
+
+   .. dropdown:: Example output of ``rocminfo``
+
+      .. code-block:: shell-session
+
+         ROCk module is loaded
+         =====================    
+         HSA System Attributes    
+         =====================    
+         Runtime Version:         1.18
+         Runtime Ext Version:     1.14
+         System Timestamp Freq.:  1000.000000MHz
+         Sig. Max Wait Duration:  18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count)
+         Machine Model:           LARGE                              
+         System Endianness:       LITTLE                             
+         Mwaitx:                  DISABLED
+         XNACK enabled:           NO
+         DMAbuf Support:          YES
+         VMM Support:             YES
+     
+         ==========               
+         HSA Agents               
+         ==========               
+         *******                  
+         Agent 1                  
+         *******                  
+           Name:                    AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+           Uuid:                    CPU-XX                             
+           Marketing Name:          AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+           Vendor Name:             CPU
+
+         [output truncated]
+   ```
+

docs/install/includes/4_rhel-wheel-post-install.md

@@ -0,0 +1,72 @@
+1. Verify the ROCm installation.
+
+   ```bash
+   rocminfo
+   amd-smi
+   ```
+
+   ```{eval-rst}
+
+   .. dropdown:: Example output of ``rocminfo``
+
+      .. code-block:: shell-session
+
+         ROCk module is loaded
+         =====================    
+         HSA System Attributes    
+         =====================    
+         Runtime Version:         1.18
+         Runtime Ext Version:     1.14
+         System Timestamp Freq.:  1000.000000MHz
+         Sig. Max Wait Duration:  18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count)
+         Machine Model:           LARGE                              
+         System Endianness:       LITTLE                             
+         Mwaitx:                  DISABLED
+         XNACK enabled:           NO
+         DMAbuf Support:          YES
+         VMM Support:             YES
+     
+         ==========               
+         HSA Agents               
+         ==========               
+         *******                  
+         Agent 1                  
+         *******                  
+           Name:                    AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+           Uuid:                    CPU-XX                             
+           Marketing Name:          AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+           Vendor Name:             CPU
+
+         [output truncated]
+   ```
+
+2. Inspect your ROCm installation in your Python environment.
+
+   ```bash
+   pip freeze | grep rocm
+   which rocm-sdk
+   ls .venv/bin
+   ```
+
+3. Test your ROCm installation.
+
+   ```bash
+   rocm-sdk targets
+   rocm-sdk path --cmake
+   rocm-sdk path --bin
+   rocm-sdk path --root
+   rocm-sdk test
+   ```
+
+   To learn more about the `rocm-sdk` tool and to see example expected outputs,
+   see [Using ROCm Python packages
+   (TheRock)](https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages).
+
+````{tip}
+If you need to deactivate your Python virtual environment when finished,
+run:
+
+```shell
+deactivate
+```
+````

docs/install/includes/4_ubuntu-wheel-post-install.md

@@ -0,0 +1,72 @@
+1. Verify the ROCm installation.
+
+   ```bash
+   rocminfo
+   amd-smi
+   ```
+
+   ```{eval-rst}
+
+   .. dropdown:: Example output of ``rocminfo``
+
+      .. code-block:: shell-session
+
+         ROCk module is loaded
+         =====================    
+         HSA System Attributes    
+         =====================    
+         Runtime Version:         1.18
+         Runtime Ext Version:     1.14
+         System Timestamp Freq.:  1000.000000MHz
+         Sig. Max Wait Duration:  18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count)
+         Machine Model:           LARGE                              
+         System Endianness:       LITTLE                             
+         Mwaitx:                  DISABLED
+         XNACK enabled:           NO
+         DMAbuf Support:          YES
+         VMM Support:             YES
+     
+         ==========               
+         HSA Agents               
+         ==========               
+         *******                  
+         Agent 1                  
+         *******                  
+           Name:                    AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+           Uuid:                    CPU-XX                             
+           Marketing Name:          AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+           Vendor Name:             CPU
+
+         [output truncated]
+   ```
+
+2. Inspect your ROCm installation in your Python environment.
+
+   ```bash
+   pip freeze | grep rocm
+   which rocm-sdk
+   ls .venv/bin
+   ```
+
+3. Test your ROCm installation.
+
+   ```bash
+   rocm-sdk targets
+   rocm-sdk path --cmake
+   rocm-sdk path --bin
+   rocm-sdk path --root
+   rocm-sdk test
+   ```
+
+   To learn more about the `rocm-sdk` tool and to see example expected outputs,
+   see [Using ROCm Python packages
+   (TheRock)](https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages).
+
+````{tip}
+If you need to deactivate your Python virtual environment when finished,
+run:
+
+```shell
+deactivate
+```
+````

docs/install/includes/4_windows-tar-post-install.md

@@ -0,0 +1,23 @@
+Verify the ROCm installation.
+
+```shell
+hipinfo
+```
+
+```{eval-rst}
+
+.. dropdown:: Example output of ``hipinfo``
+
+   .. code-block:: shell-session
+
+      --------------------------------------------------------------------------------
+      device#                           0
+      Name:                             AMD Radeon(TM) 8060S Graphics
+      pciBusID:                         197
+      pciDeviceID:                      0
+      pciDomainID:                      0
+      multiProcessorCount:              20
+
+      [output truncated]
+```
+

docs/install/includes/4_windows-wheel-post-install.md

@@ -0,0 +1,50 @@
+1. Verify the ROCm installation.
+
+   ```bash
+   hipinfo
+   ```
+
+   ```{eval-rst}
+
+   .. dropdown:: Example output of ``hipinfo``
+
+      .. code-block:: shell-session
+
+         --------------------------------------------------------------------------------
+         device#                           0
+         Name:                             AMD Radeon(TM) 8060S Graphics
+         pciBusID:                         197
+         pciDeviceID:                      0
+         pciDomainID:                      0
+         multiProcessorCount:              20
+
+         [output truncated]
+   ```
+
+
+2. Inspect your ROCm installation in your Python environment.
+
+   ```bash
+   pip freeze
+   where rocm-sdk
+   dir .venv\Scripts
+   ```
+
+3. Test your ROCm installation.
+
+   ```bash
+   rocm-sdk test
+   ```
+
+   To learn more about the `rocm-sdk` tool and to see example expected outputs,
+   see [Using ROCm Python packages
+   (TheRock)](https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages).
+
+````{tip}
+If you need to deactivate your Python virtual environment when finished,
+run:
+
+```shell
+deactivate
+```
+````

docs/install/includes/5_tar-uninstall.md

@@ -0,0 +1,5 @@
+To uninstall ROCm, remove your installation directory.
+
+```bash
+sudo rm -rf therock-tarball
+```

docs/install/includes/5_wheel-linux-uninstall.md

@@ -0,0 +1,11 @@
+1. Clear the pip cache.
+
+   ```bash
+   sudo rm -rf ~/.cache/pip
+   ```
+
+2. Remove your local Python virtual environment.
+
+   ```bash
+   sudo rm -rf .venv
+   ```

docs/install/includes/5_wheel-windows-uninstall.md

@@ -0,0 +1,11 @@
+1. Clear the pip cache.
+
+   ```bash
+   pip cache purge
+   ```
+
+2. Remove your local Python virtual environment.
+
+   ```bash
+   rmdir /s /q .venv
+   ```

docs/install/includes/5_windows-tar-uninstall.md

@@ -0,0 +1,18 @@
+1. Delete the `C:\TheRock\build` and its contents.
+
+2. Delete the environment variables. For example, using Powershell as an administrator:
+
+  ```powershell
+  [Environment]::SetEnvironmentVariable("HIP_PATH", $null, "Machine")
+  [Environment]::SetEnvironmentVariable("HIP_DEVICE_LIB_PATH", $null, "Machine")
+  [Environment]::SetEnvironmentVariable("HIP_PLATFORM", $null, "Machine")
+  [Environment]::SetEnvironmentVariable("LLVM_PATH", $null, "Machine")
+  ```
+
+3. Remove the following paths from your PATH environment variable using your system settings GUI.
+
+   - `C:\TheRock\build\bin`
+
+   - `C:\TheRock\build\lib\llvm\bin`
+
+4. If you want to uninstall the Adrenalin driver, see [Uninstall AMD Software](https://www.amd.com/en/resources/support-articles/faqs/RSX2-UNINSTALL.html).

docs/install/includes/6_rhel-troubleshooting.md

@@ -0,0 +1,8 @@
+Docker images often only include a minimal set of installations, meaning some
+essential packages might be missing. When installing ROCm within a Docker
+container, you might need to install additional packages for a successful
+installation. Use the following commands to install the prerequisite packages.
+
+```bash
+dnf install sudo libatomic
+```

docs/install/includes/6_ubuntu-troubleshooting.md

@@ -0,0 +1,9 @@
+Docker images often only include a minimal set of installations, meaning some
+essential packages might be missing. When installing ROCm within a Docker
+container, you might need to install additional packages for a successful
+installation. Use the following commands to install the prerequisite packages.
+
+```bash
+apt update
+apt install sudo wget
+```

docs/install/pytorch-comfyui.rst

@@ -0,0 +1,169 @@
+.. meta::
+   :description: Step-by-step guide to installing PyTorch with AMD ROCm 7.9.0 and setting up ComfyUI for AI image generation on Ryzen AI (gfx1151) APUs. Covers Linux and Windows installation, environment setup, and troubleshooting.
+   :keywords: PyTorch ROCm, ComfyUI, ROCm 7.9.0, AMD GPU, Ryzen AI APU, install PyTorch ROCm, ROCm PyTorch Windows, ROCm PyTorch Linux, ROCm AI image generation, ROCm gfx1151, ComfyUI ROCm setup, PyTorch 2.9.0 ROCm
+
+*****************************************
+Install PyTorch and ComfyUI on ROCm 7.9.0
+*****************************************
+
+This guide walks you through installing PyTorch with ROCm support on AMD
+hardware. It applies to :ref:`supported AMD GPUs and platforms
+<790-supported-hw>`. It also includes additional setup steps for ComfyUI on
+Windows using Ryzen AI (gfx1151) APUs, showcasing AI-powered image generation.
+
+Prerequisites
+=============
+
+Before beginning, ensure your system meets these requirements:
+
+- Python version: 3.11, 3.12, or 3.13 installed and accessible
+
+- ROCm 7.9.0: A working ROCm installation (if not already installed via pip, this guide covers the setup)
+
+Review the :doc:`ROCm 7.9.0 compatibility <compatibility-matrix>` information.
+
+.. _790-install-pyt:
+
+Install PyTorch
+===============
+
+For prerequisite steps and post-installation recommendations, see :doc:`rocm`.
+
+1. Set up your Python virtual environment. If you already have a successful
+   :doc:`ROCm 7.9.0 installation via pip <rocm>`, skip this step.
+
+   .. code-block:: shell
+
+      python3.12 -m venv .venv
+
+2. Activate your Python virtual environment.
+
+   .. tab-set::
+
+      .. tab-item:: Linux
+         :sync: linux
+
+         .. code-block:: shell
+
+            source .venv/bin/activate
+
+      .. tab-item:: Windows
+         :sync: windows
+
+         .. code-block:: shell
+
+            .venv\Scripts\activate
+
+3. Install the appropriate ROCm-enabled PyTorch build for your operating system
+   and AMD hardware architecture.
+
+   .. tab-set::
+
+      .. tab-item:: Linux (PyTorch 2.7.1)
+         :sync: linux
+
+         .. tab-set::
+
+            .. tab-item:: Instinct MI350 Series
+               :sync: gfx950
+
+               .. code-block:: bash
+
+                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ torch torchvision torchaudio
+
+            .. tab-item:: Instinct MI300 Series
+               :sync: gfx942
+
+               .. code-block:: bash
+
+                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ torch torchvision torchaudio
+
+            .. tab-item:: Ryzen AI Max APU
+               :sync: gfx1151
+
+               .. code-block:: bash
+
+                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ torch torchvision torchaudio
+
+      .. tab-item:: Windows (PyTorch 2.9.0)
+         :sync: windows
+
+         .. tab-set::
+
+            .. tab-item:: Ryzen AI Max APU
+               :sync: gfx1151
+
+               .. code-block:: bash
+
+                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ torch torchvision torchaudio
+
+4. Check your PyTorch installation.
+
+   .. code-block:: shell
+
+      python -c "import torch; print(torch.cuda.is_available())"
+
+   This prints ``True`` if PyTorch and ROCm are installed properly.
+
+Optionally, if you're running Windows on a supported Ryzen AI APU, try
+:ref:`ComfyUI on Windows <790-install-comfyui>`.
+
+.. _790-install-comfyui:
+
+Install ComfyUI on Windows
+==========================
+
+ComfyUI is tested for support only on Ryzen AI (gfx1151) APUs on
+Windows.
+
+1. Ensure your working environment is running ROCm-enabled PyTorch 2.9.0 on Windows.
+   See :ref:`Install PyTorch <790-install-pyt>`.
+
+2. Clone the ComfyUI repository.
+
+   .. code-block:: shell
+
+      git clone https://github.com/comfyanonymous/ComfyUI.git
+
+3. Install Python dependencies.
+
+   .. code-block:: shell
+
+      pip install -r ComfyUI\requirements.txt
+
+4. Run ComfyUI.
+
+   a. Start the ComfyUI server from the command line.
+
+      .. code-block:: bash
+
+         python ComfyUI\main.py
+
+      This will start the server and display a prompt like:
+
+      .. code-block:: text
+
+         To see the GUI go to: http://127.0.0.1:8188
+
+   b. Navigate to ``http://127.0.0.1:8188`` in your web browser. You might need to
+      replace `8188` with the appropriate port number.
+
+      .. image:: /data/comfyui.png
+         :align: center
+
+   c. Search for the "Chroma1 Radiance text to image" template.
+
+      - Select **Template** → **Images** → **Chroma1_radiance**.
+      - Download any missing required models.
+
+      .. image:: /data/comfyui-missing-models.png
+         :align: center
+
+   d. Click the **Run** button.
+
+   The application will use your AMD GPU to convert the prompted text to an image.
+
+Known limitations
+-----------------
+
+ComfyUI might not start if Smart App Control is enabled.

docs/install/rocm.rst

@@ -0,0 +1,441 @@
+.. meta::
+   :description: Learn how to install AMD ROCm 7.9.0 for supported Instinct GPUs and Ryzen AI APUs on Ubuntu, RHEL, and Windows. This step-by-step guide covers prerequisites, driver setup, installation methods (pip and tarball), and troubleshooting.
+   :keywords: AMD ROCm 7.9.0, install ROCm, Instinct GPU, Ryzen APU, Ubuntu, RHEL, Windows, pip install ROCm, ROCm wheel, ROCm tarball, ROCm GPU driver, ROCm setup, ROCm uninstall, ROCm troubleshooting**********************
+
+Install AMD ROCm 7.9.0
+**********************
+
+Use the following selector to choose your installation method for your
+supported AMD GPU or APU and operating system. For information about supported
+operating systems and compatible AMD devices, see the :doc:`Compatibility matrix
+<compatibility-matrix>`.
+
+.. selector:: AMD product family
+   :key: plat
+
+   .. selector-option:: Instinct GPU
+      :value: instinct
+      :width: 6
+
+   .. selector-option:: Ryzen APU
+      :value: ryzen
+      :width: 6
+
+.. selected:: plat=instinct
+
+   .. selector:: Instinct GPU
+      :key: instinct-arch
+
+      .. selector-option:: Instinct MI355X, MI350X
+         :value: gfx950
+
+      .. selector-option:: Instinct MI325X, MI300X, MI300A
+         :value: gfx942
+
+   .. selector:: Operating system
+      :key: instinct-os
+
+      .. selector-option:: Ubuntu
+         :value: ubuntu
+         :icon: fab fa-linux fa-lg
+
+      .. selector-option:: Red Hat Enterprise Linux
+         :value: rhel
+         :icon: fab fa-linux fa-lg
+
+   .. selector:: Ubuntu version
+      :key: instinct-ubuntu-version
+      :show-when: instinct-os=ubuntu
+
+      .. selector-option:: 24.04.3
+         :value: 24.04
+         :icon: fab fa-ubuntu fa-lg
+
+      .. selector-option:: 22.04.5
+         :value: 22.04
+         :icon: fab fa-ubuntu fa-lg
+
+   .. selector:: RHEL version
+      :key: instinct-rhel-version
+      :show-when: instinct-os=rhel
+
+      .. selector-option:: 10.0
+         :value: 10.0
+         :icon: fab fa-redhat fa-lg
+
+      .. selector-option:: 9.6
+         :value: 9.6
+         :icon: fab fa-redhat fa-lg
+
+.. selected:: plat=ryzen
+
+   .. selector:: Ryzen APU
+      :key: ryzen
+
+      .. selector-option:: Ryzen AI Max+ PRO 395, 390, 385, 380
+         :value: ryzen-ai-max-pro
+         :width: 7
+
+      .. selector-option:: Ryzen AI Max 395, 390, 385
+         :value: ryzen-ai-max
+         :width: 5
+
+   .. selector:: Operating system
+      :key: ryzen-os
+
+      .. selector-option:: Ubuntu
+         :value: ubuntu
+         :icon: fab fa-linux fa-lg
+
+      .. selector-option:: Windows
+         :value: windows
+         :icon: fab fa-windows fa-lg
+
+   .. selector:: Ubuntu version
+      :key: ryzen-ubuntu-version
+      :show-when: ryzen-os=ubuntu
+
+      .. selector-option:: 24.04.3
+         :value: 24.04
+         :icon: fab fa-ubuntu fa-lg
+         :width: 12
+
+   .. selector:: Windows version
+      :key: ryzen-windows-version
+      :show-when: ryzen-os=windows
+
+      .. selector-option:: 11 24H2
+         :value: 11_24h2
+         :icon: fab fa-windows fa-lg
+         :width: 12
+
+.. selector:: Installation method
+   :key: install-method
+
+   .. selector-option:: pip
+      :value: wheel
+
+   .. selector-option:: Tarball
+      :value: tar
+
+.. selected:: install-method=wheel
+   :heading: Prerequisites
+
+   .. selected:: plat=instinct
+
+      .. selected:: instinct-os=ubuntu
+
+         .. selected:: instinct-ubuntu-version=22.04
+
+            .. include:: ./includes/1_ubuntu-22.04-wheel-prerequisites.md
+               :parser: myst
+
+         .. selected:: instinct-ubuntu-version=24.04
+
+            .. include:: ./includes/1_ubuntu-24.04-wheel-prerequisites.md
+               :parser: myst
+
+      .. selected:: instinct-os=rhel
+
+         .. selected:: instinct-rhel-version=9.6
+
+            .. include:: ./includes/1_rhel-9.6-wheel-prerequisites.md
+               :parser: myst
+
+         .. selected:: instinct-rhel-version=10.0
+
+            .. include:: ./includes/1_rhel-10.0-wheel-prerequisites.md
+               :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. selected:: ryzen-ubuntu-version=24.04
+
+            .. include:: ./includes/1_ubuntu-24.04-wheel-prerequisites.md
+               :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/1_windows-wheel-prerequisites.md
+            :parser: myst
+
+.. selected:: install-method=tar
+   :heading: Prerequisites
+
+   .. selected:: plat=instinct
+
+      .. selected:: instinct-os=ubuntu
+
+         .. include:: ./includes/1_ubuntu-tar-prerequisites.md
+            :parser: myst
+
+      .. selected:: instinct-os=rhel
+
+         .. selected:: instinct-rhel-version=9.6
+
+            .. include:: ./includes/1_rhel-9.6-tar-prerequisites.md
+               :parser: myst
+
+         .. selected:: instinct-rhel-version=10.0
+
+            .. include:: ./includes/1_rhel-10.0-tar-prerequisites.md
+               :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. include:: ./includes/1_ubuntu-tar-prerequisites.md
+            :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/1_windows-tar-prerequisites.md
+            :parser: myst
+
+.. selected:: plat=instinct
+   :heading: Installing
+
+   .. selected:: instinct-os=ubuntu
+      :heading: Install AMD GPU Driver
+      :heading-level: 3
+
+      .. include:: ./includes/2_ubuntu-instinct-install-kmd.md
+         :parser: myst
+
+   .. selected:: instinct-os=rhel
+      :heading: Install AMD GPU Driver
+      :heading-level: 3
+
+      .. include:: ./includes/2_rhel-instinct-install-kmd.md
+         :parser: myst
+
+.. selected:: plat=ryzen
+   :heading: Installing
+
+   .. selected:: ryzen-os=ubuntu
+      :heading: Install kernel driver
+      :heading-level: 3
+
+      Supported Ryzen AI APUs require the inbox kernel driver included with
+      Ubuntu 24.04.3.
+
+.. selected:: install-method=wheel
+   :heading: Install ROCm
+   :heading-level: 3
+
+   .. selected:: plat=instinct
+
+      .. selected:: instinct-arch=gfx950
+
+         .. selected:: instinct-os=ubuntu
+
+            .. selected:: instinct-ubuntu-version=22.04
+
+               .. include:: ./includes/3_wheel-gfx950-install-rocm-py311.md
+                  :parser: myst
+
+            .. selected:: instinct-ubuntu-version=24.04
+
+               .. include:: ./includes/3_wheel-gfx950-install-rocm.md
+                  :parser: myst
+
+         .. selected:: instinct-os=rhel
+
+            .. selected:: instinct-rhel-version=10.0
+
+               .. include:: ./includes/3_wheel-gfx950-install-rocm.md
+                  :parser: myst
+
+            .. selected:: instinct-rhel-version=9.6
+
+               .. include:: ./includes/3_wheel-gfx950-install-rocm-py311.md
+                  :parser: myst
+
+      .. selected:: instinct-arch=gfx942
+
+         .. selected:: instinct-os=ubuntu
+
+            .. selected:: instinct-ubuntu-version=22.04
+
+               .. include:: ./includes/3_wheel-gfx942-install-rocm-py311.md
+                  :parser: myst
+
+            .. selected:: instinct-ubuntu-version=24.04
+
+               .. include:: ./includes/3_wheel-gfx942-install-rocm.md
+                  :parser: myst
+
+         .. selected:: instinct-os=rhel
+
+            .. selected:: instinct-rhel-version=10.0
+
+               .. include:: ./includes/3_wheel-gfx942-install-rocm.md
+                  :parser: myst
+
+            .. selected:: instinct-rhel-version=9.6
+
+               .. include:: ./includes/3_wheel-gfx942-install-rocm-py311.md
+                  :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. include:: ./includes/3_wheel-gfx1151-install-rocm.md
+            :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/3_windows-wheel-install-rocm.md
+            :parser: myst
+
+.. selected:: install-method=tar
+   :heading: Install ROCm
+   :heading-level: 3
+
+   .. selected:: plat=instinct
+
+      .. selected:: instinct-arch=gfx950
+
+         .. include:: ./includes/3_tar-gfx950-install-rocm.md
+            :parser: myst
+
+      .. selected:: instinct-arch=gfx942
+
+         .. include:: ./includes/3_tar-gfx942-install-rocm.md
+            :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. include:: ./includes/3_tar-gfx1151-install-rocm.md
+            :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/3_windows-tar-install-rocm.md
+            :parser: myst
+
+.. selected:: install-method=tar
+   :heading: Post-installation
+
+   .. selected:: plat=instinct
+
+      .. include:: ./includes/4_linux-tar-post-install.md
+         :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. include:: ./includes/4_linux-tar-post-install.md
+            :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/4_windows-tar-post-install.md
+            :parser: myst
+
+.. selected:: install-method=wheel
+   :heading: Post-installation
+
+   .. selected:: plat=instinct
+
+      .. selected:: instinct-os=ubuntu
+
+         .. include:: ./includes/4_ubuntu-wheel-post-install.md
+            :parser: myst
+
+      .. selected:: instinct-os=rhel
+
+         .. include:: ./includes/4_rhel-wheel-post-install.md
+            :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. include:: ./includes/4_ubuntu-wheel-post-install.md
+            :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/4_windows-wheel-post-install.md
+            :parser: myst
+
+.. selected:: install-method=tar
+   :heading: Uninstalling
+
+   .. selected:: plat=instinct
+
+      .. include:: ./includes/5_tar-uninstall.md
+         :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. include:: ./includes/5_tar-uninstall.md
+            :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/5_windows-tar-uninstall.md
+            :parser: myst
+
+.. selected:: install-method=wheel
+   :heading: Uninstalling
+
+   .. selected:: plat=instinct
+
+      .. include:: ./includes/5_wheel-linux-uninstall.md
+         :parser: myst
+
+   .. selected:: plat=ryzen
+
+      .. selected:: ryzen-os=ubuntu
+
+         .. include:: ./includes/5_wheel-linux-uninstall.md
+            :parser: myst
+
+      .. selected:: ryzen-os=windows
+
+         .. include:: ./includes/5_wheel-windows-uninstall.md
+            :parser: myst
+
+.. selected:: plat=instinct
+   :heading: Troubleshooting
+
+   .. selected:: instinct-os=ubuntu
+
+      .. selected:: instinct-os=ubuntu
+         :heading-level: 3
+         :heading: Additional packages for Docker installation
+
+         .. include:: ./includes/6_ubuntu-troubleshooting.md
+            :parser: myst
+
+   .. selected:: instinct-os=rhel
+
+      .. selected:: instinct-os=rhel
+         :heading-level: 3
+         :heading: Additional packages for Docker installation
+
+         .. include:: ./includes/6_rhel-troubleshooting.md
+            :parser: myst
+
+.. selected:: plat=ryzen
+
+   .. selected:: ryzen-os=ubuntu
+      :heading: Troubleshooting
+
+      .. selected:: ryzen-os=ubuntu
+         :heading-level: 3
+         :heading: Additional packages for Docker installation
+
+      .. include:: ./includes/6_ubuntu-troubleshooting.md
+         :parser: myst