Install JAX for ROCm#
This page guides you through installing JAX with ROCm support on AMD hardware. It applies to supported AMD GPUs and platforms.
Prerequisites#
Ensure your system has the AMD GPU Driver (amdgpu) installed. See the ROCm compatibility matrix for driver support information. For installation instructions, see the AMD GPU Driver documentation.
Ensure your system has the AMD GPU Driver (amdgpu) installed. See the ROCm compatibility matrix for driver support information. For installation instructions, see the AMD GPU Driver documentation.
Ensure your system has the AMD GPU Driver (amdgpu) installed. See the ROCm compatibility matrix for driver support information. For installation instructions, see the AMD GPU Driver documentation.
Ensure your system has the AMD GPU Driver (amdgpu) installed. See the ROCm compatibility matrix for driver support information. For installation instructions, see the AMD GPU Driver documentation.
Ensure the host system has Docker Engine installed. For more guidance on running ROCm workloads in Docker containers, see Run ROCm Docker containers.
Install ROCm 10.2.0.
Install ROCm 10.1.0.
Install ROCm 10.0.0.
Install ROCm 7.14.1.
Install ROCm 7.14.0.
Ensure your system has a supported Python version installed and accessible: 3.11, 3.12, 3.13, or 3.14.
Ensure your system has a supported Python version installed and accessible: 3.12, 3.13, or 3.14.
Important
Unlike PyTorch, the JAX packages don’t automatically install ROCm library and device packages as dependencies. The following section includes recommended instructions to install ROCm in a Python virtual environment alongside JAX. See Install ROCm for other installation methods.
Get started#
Pull the ROCm JAX 0.11.2 Docker image.
docker pull rocm/jax:rocm10.2.0_ubuntu26.04_py3.14_jax_release_0.11.2
docker pull rocm/jax:rocm10.2.0_ubuntu24.04_py3.12_jax_release_0.11.2
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.2.0_ubuntu26.04_py3.14_jax_release_0.11.2 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.2.0_ubuntu24.04_py3.12_jax_release_0.11.2 \ bash
Pull the ROCm JAX 0.11.1 Docker image.
docker pull rocm/jax:rocm10.2.0_ubuntu26.04_py3.14_jax_release_0.11.1
docker pull rocm/jax:rocm10.2.0_ubuntu24.04_py3.12_jax_release_0.11.1
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.2.0_ubuntu26.04_py3.14_jax_release_0.11.1 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.2.0_ubuntu24.04_py3.12_jax_release_0.11.1 \ bash
Pull the ROCm JAX 0.10.2 Docker image.
docker pull rocm/jax:rocm10.2.0_ubuntu26.04_py3.14_jax_release_0.10.2
docker pull rocm/jax:rocm10.2.0_ubuntu24.04_py3.12_jax_release_0.10.2
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.2.0_ubuntu26.04_py3.14_jax_release_0.10.2 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.2.0_ubuntu24.04_py3.12_jax_release_0.10.2 \ bash
Get started#
Pull the ROCm JAX 0.11.1 Docker image.
docker pull rocm/jax:rocm10.1.0_ubuntu26.04_py3.14_jax_release_0.11.1
docker pull rocm/jax:rocm10.1.0_ubuntu24.04_py3.12_jax_release_0.11.1
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.1.0_ubuntu26.04_py3.14_jax_release_0.11.1 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.1.0_ubuntu24.04_py3.12_jax_release_0.11.1 \ bash
Pull the ROCm JAX 0.11.0 Docker image.
docker pull rocm/jax:rocm10.1.0_ubuntu26.04_py3.14_jax_release_0.11.0
docker pull rocm/jax:rocm10.1.0_ubuntu24.04_py3.12_jax_release_0.11.0
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.1.0_ubuntu26.04_py3.14_jax_release_0.11.0 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.1.0_ubuntu24.04_py3.12_jax_release_0.11.0 \ bash
Pull the ROCm JAX 0.10.2 Docker image.
docker pull rocm/jax:rocm10.1.0_ubuntu26.04_py3.14_jax_release_0.10.2
docker pull rocm/jax:rocm10.1.0_ubuntu24.04_py3.12_jax_release_0.10.2
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.1.0_ubuntu26.04_py3.14_jax_release_0.10.2 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.1.0_ubuntu24.04_py3.12_jax_release_0.10.2 \ bash
Get started#
Pull the ROCm JAX 0.11.0 Docker image.
docker pull rocm/jax:rocm10.0-jax0.11.0-py3.14
docker pull rocm/jax:rocm10.0-jax0.11.0-py3.13
docker pull rocm/jax:rocm10.0-jax0.11.0-py3.12
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.11.0-py3.14 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.11.0-py3.13 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.11.0-py3.12 \ bash
Pull the ROCm JAX 0.10.2 Docker image.
docker pull rocm/jax:rocm10.0-jax0.10.2-py3.14
docker pull rocm/jax:rocm10.0-jax0.10.2-py3.13
docker pull rocm/jax:rocm10.0-jax0.10.2-py3.12
docker pull rocm/jax:rocm10.0-jax0.10.2-py3.11
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.2-py3.14 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.2-py3.13 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.2-py3.12 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.2-py3.11 \ bash
Pull the ROCm JAX 0.10.0 Docker image.
docker pull rocm/jax:rocm10.0-jax0.10.0-py3.14
docker pull rocm/jax:rocm10.0-jax0.10.0-py3.13
docker pull rocm/jax:rocm10.0-jax0.10.0-py3.12
docker pull rocm/jax:rocm10.0-jax0.10.0-py3.11
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.0-py3.14 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.0-py3.13 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.0-py3.12 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm10.0-jax0.10.0-py3.11 \ bash
Get started#
Pull the ROCm JAX 0.10.0 Docker image.
docker pull rocm/jax:rocm7.14.1-jax0.10.0-py3.14
docker pull rocm/jax:rocm7.14.1-jax0.10.0-py3.13
docker pull rocm/jax:rocm7.14.1-jax0.10.0-py3.12
docker pull rocm/jax:rocm7.14.1-jax0.10.0-py3.11
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.10.0-py3.14 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.10.0-py3.13 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.10.0-py3.12 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.10.0-py3.11 \ bash
Pull the ROCm JAX 0.9.1 Docker image.
docker pull rocm/jax:rocm7.14.1-jax0.9.1-py3.14
docker pull rocm/jax:rocm7.14.1-jax0.9.1-py3.13
docker pull rocm/jax:rocm7.14.1-jax0.9.1-py3.12
docker pull rocm/jax:rocm7.14.1-jax0.9.1-py3.11
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.9.1-py3.14 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.9.1-py3.13 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.9.1-py3.12 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14.1-jax0.9.1-py3.11 \ bash
Get started#
Pull the ROCm JAX 0.10.0 Docker image.
docker pull rocm/jax:rocm7.14-jax0.10.0-py3.14
docker pull rocm/jax:rocm7.14-jax0.10.0-py3.13
docker pull rocm/jax:rocm7.14-jax0.10.0-py3.12
docker pull rocm/jax:rocm7.14-jax0.10.0-py3.11
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.10.0-py3.14 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.10.0-py3.13 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.10.0-py3.12 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.10.0-py3.11 \ bash
Pull the ROCm JAX 0.9.1 Docker image.
docker pull rocm/jax:rocm7.14-jax0.9.1-py3.14
docker pull rocm/jax:rocm7.14-jax0.9.1-py3.13
docker pull rocm/jax:rocm7.14-jax0.9.1-py3.12
docker pull rocm/jax:rocm7.14-jax0.9.1-py3.11
Start the Docker container.
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.9.1-py3.14 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.9.1-py3.13 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.9.1-py3.12 \ bash
docker run -it --rm \ --device /dev/kfd \ --device /dev/dri \ --network=host \ --ipc=host \ --group-add=video \ --cap-add=SYS_PTRACE \ --security-opt seccomp=unconfined \ rocm/jax:rocm7.14-jax0.9.1-py3.11 \ bash
Install JAX using pip#
For prerequisite steps and post-installation recommendations, see the ROCm installation instructions.
For prerequisite steps and post-installation recommendations, see the ROCm installation instructions.
For prerequisite steps and post-installation recommendations, see the ROCm installation instructions.
For prerequisite steps and post-installation recommendations, see the ROCm installation instructions.
For prerequisite steps and post-installation recommendations, see the ROCm installation instructions.
Set up and activate your Python virtual environment.
python3.14 -m venv .venv source .venv/bin/activate
python3.13 -m venv .venv source .venv/bin/activate
python3.12 -m venv .venv source .venv/bin/activate
python3.14 -m venv .venv source .venv/bin/activate
python3.13 -m venv .venv source .venv/bin/activate
python3.12 -m venv .venv source .venv/bin/activate
python3.11 -m venv .venv source .venv/bin/activate
If you don’t have an existing ROCm 10.2.0 installation, you can install ROCm using pip as follows. See the ROCm 10.2.0 installation instructions for complete guidance and other ROCm installation methods. Otherwise, proceed to installing JAX libraries.
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-all]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx950]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx942]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx90a]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1200]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1201]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1100]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1101]==10.2.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1102]==10.2.0"
Install the ROCm-enabled JAX libraries.
Note
The
jaxandjaxlibpackages are not published to the AMD package repository. After installing GFX architecture-basedjax_rocm10_pluginandjax_rocm10_pjrtpackages from the AMD repository, installjaxandjaxlibfrom PyPI.python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.11.2+rocm10.2.0" \ "jax_rocm10_pjrt==0.11.2+rocm10.2.0" # Install jax from PyPI python -m pip install \ "jax==0.11.2" \ "jaxlib==0.11.2"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.11.1+rocm10.2.0" \ "jax_rocm10_pjrt==0.11.1+rocm10.2.0" # Install jax from PyPI python -m pip install \ "jax==0.11.1" \ "jaxlib==0.11.1"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.10.2+rocm10.2.0" \ "jax_rocm10_pjrt==0.10.2+rocm10.2.0" # Install jax from PyPI python -m pip install \ "jax==0.10.2" \ "jaxlib==0.10.2"
If you don’t have an existing ROCm 10.1.0 installation, you can install ROCm using pip as follows. See the ROCm 10.1.0 installation instructions for complete guidance and other ROCm installation methods. Otherwise, proceed to installing JAX libraries.
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-all]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx950]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx942]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx90a]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1200]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1201]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1100]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1101]==10.1.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1102]==10.1.0"
Install the ROCm-enabled JAX libraries.
Note
The
jaxandjaxlibpackages are not published to the AMD package repository. After installing GFX architecture-basedjax_rocm10_pluginandjax_rocm10_pjrtpackages from the AMD repository, installjaxandjaxlibfrom PyPI.python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.11.1+rocm10.1.0" \ "jax_rocm10_pjrt==0.11.1+rocm10.1.0" # Install jax from PyPI python -m pip install \ "jax==0.11.1" \ "jaxlib==0.11.1"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.11.0+rocm10.1.0" \ "jax_rocm10_pjrt==0.11.0+rocm10.1.0" # Install jax from PyPI python -m pip install \ "jax==0.11.0" \ "jaxlib==0.11.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.10.2+rocm10.1.0" \ "jax_rocm10_pjrt==0.10.2+rocm10.1.0" # Install jax from PyPI python -m pip install \ "jax==0.10.2" \ "jaxlib==0.10.2"
If you don’t have an existing ROCm 10.0.0 installation, you can install ROCm using pip as follows. See the ROCm 10.0.0 installation instructions for complete guidance and other ROCm installation methods. Otherwise, proceed to installing JAX libraries.
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-all]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx950]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx942]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx90a]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1200]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1201]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1100]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1101]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1102]==10.0.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "rocm[libraries,device-gfx1103]==10.0.0"
Install the ROCm-enabled JAX libraries.
Note
The
jaxandjaxlibpackages are not published to the AMD package repository. After installing GFX architecture-basedjax_rocm10_pluginandjax_rocm10_pjrtpackages from the AMD repository, installjaxandjaxlibfrom PyPI.python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.11.0+rocm10.0.0" \ "jax_rocm10_pjrt==0.11.0+rocm10.0.0" # Install jax from PyPI python -m pip install \ "jax==0.11.0" \ "jaxlib==0.11.0"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.10.2+rocm10.0.0" \ "jax_rocm10_pjrt==0.10.2+rocm10.0.0" # Install jax from PyPI python -m pip install \ "jax==0.10.2" \ "jaxlib==0.10.2"
python -m pip install --index-url https://stable.repo.amd.com/rocm/whl-next/ \ "jax_rocm10_plugin==0.10.0+rocm10.0.0" \ "jax_rocm10_pjrt==0.10.0+rocm10.0.0" # Install jax from PyPI python -m pip install \ "jax==0.10.0" \ "jaxlib==0.10.0"
If you don’t have an existing ROCm 7.14.1 installation, you can install ROCm using pip as follows. See the ROCm 7.14.1 installation instructions for complete guidance and other ROCm installation methods. Otherwise, proceed to installing JAX libraries.
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-all]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx950]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx942]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx90a]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1200]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1201]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1100]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1101]==7.14.1"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1102]==7.14.1"
Install the ROCm-enabled JAX libraries.
Note
The
jaxandjaxlibpackages are not published to the AMD package repository. After installing GFX architecture-basedjax_rocm7_pluginandjax_rocm7_pjrtpackages from the AMD repository, installjaxandjaxlibfrom PyPI.python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "jax_rocm7_plugin==0.10.0+rocm7.14.1" \ "jax_rocm7_pjrt==0.10.0+rocm7.14.1" # Install jax from PyPI python -m pip install \ "jax==0.10.0" \ "jaxlib==0.10.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "jax_rocm7_plugin==0.9.1+rocm7.14.1" \ "jax_rocm7_pjrt==0.9.1+rocm7.14.1" # Install jax from PyPI python -m pip install \ "jax==0.9.1" \ "jaxlib==0.9.1"
If you don’t have an existing ROCm 7.14.0 installation, you can install ROCm using pip as follows. See the ROCm 7.14.0 installation instructions for complete guidance and other ROCm installation methods. Otherwise, proceed to installing JAX libraries.
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-all]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx950]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx942]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx90a]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1200]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1201]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1100]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1101]==7.14.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "rocm[libraries,device-gfx1102]==7.14.0"
Install the ROCm-enabled JAX libraries.
Note
The
jaxandjaxlibpackages are not published to the AMD package repository. After installing GFX architecture-basedjax_rocm7_pluginandjax_rocm7_pjrtpackages from the AMD repository, installjaxandjaxlibfrom PyPI.python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "jax_rocm7_plugin==0.10.0+rocm7.14.0" \ "jax_rocm7_pjrt==0.10.0+rocm7.14.0" # Install jax from PyPI python -m pip install \ "jax==0.10.0" \ "jaxlib==0.10.0"
python -m pip install --index-url https://repo.amd.com/rocm/whl-multi-arch/ \ "jax_rocm7_plugin==0.9.1+rocm7.14.0" \ "jax_rocm7_pjrt==0.9.1+rocm7.14.0" # Install jax from PyPI python -m pip install \ "jax==0.9.1" \ "jaxlib==0.9.1"
Verify your JAX installation.
python -c "import jax; print('JAX:', jax.__version__); print('Backend:', jax.default_backend()); print('Devices:', jax.devices())"
You should see output similar to the following with at least one GPU listed:
JAX: 0.11.2 Backend: gpu Devices: [RocmDevice(id=0)]
JAX: 0.11.1 Backend: gpu Devices: [RocmDevice(id=0)]
JAX: 0.10.2 Backend: gpu Devices: [RocmDevice(id=0)]
Known issues#
JAX BERT FP16 training workloads might encounter a segmentation fault on some AMD Radeon graphics products, such as the Radeon PRO W7900, causing training to terminate unexpectedly. As a workaround, disable XLA GPU command buffers by setting the following environment variable before launching the workload:
export XLA_FLAGS="--xla_gpu_enable_command_buffer="