#!/usr/bin/env python3 """Generates a matrix to be utilized through github actions Will output a condensed version of the matrix if on a pull request that only includes the latest version of python we support built on three different architectures: * CPU * Latest CUDA * Latest ROCM * Latest XPU """ import os from typing import Optional # NOTE: Also update the CUDA sources in tools/nightly.py when changing this list CUDA_ARCHES = ["11.8", "12.4", "12.6", "12.8"] CUDA_ARCHES_FULL_VERSION = { "11.8": "11.8.0", "12.4": "12.4.1", "12.6": "12.6.3", "12.8": "12.8.0", } CUDA_ARCHES_CUDNN_VERSION = { "11.8": "9", "12.4": "9", "12.6": "9", "12.8": "9", } # NOTE: Also update the ROCm sources in tools/nightly.py when changing this list ROCM_ARCHES = ["6.2.4", "6.3"] XPU_ARCHES = ["xpu"] CPU_CXX11_ABI_ARCH = ["cpu-cxx11-abi"] CPU_AARCH64_ARCH = ["cpu-aarch64"] CPU_S390X_ARCH = ["cpu-s390x"] CUDA_AARCH64_ARCHES = ["12.6-aarch64", "12.8-aarch64"] PYTORCH_EXTRA_INSTALL_REQUIREMENTS = { "11.8": ( "nvidia-cuda-nvrtc-cu11==11.8.89; platform_system == 'Linux' and platform_machine == 'x86_64' | " # noqa: B950 "nvidia-cuda-runtime-cu11==11.8.89; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cuda-cupti-cu11==11.8.87; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cudnn-cu11==9.1.0.70; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cublas-cu11==11.11.3.6; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cufft-cu11==10.9.0.58; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-curand-cu11==10.3.0.86; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusolver-cu11==11.4.1.48; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusparse-cu11==11.7.5.86; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nccl-cu11==2.21.5; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nvtx-cu11==11.8.86; platform_system == 'Linux' and platform_machine == 'x86_64'" ), "12.4": ( "nvidia-cuda-nvrtc-cu12==12.4.127; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cuda-runtime-cu12==12.4.127; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cuda-cupti-cu12==12.4.127; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cudnn-cu12==9.1.0.70; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cublas-cu12==12.4.5.8; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cufft-cu12==11.2.1.3; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-curand-cu12==10.3.5.147; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusolver-cu12==11.6.1.9; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusparse-cu12==12.3.1.170; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusparselt-cu12==0.6.2; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nccl-cu12==2.25.1; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nvtx-cu12==12.4.127; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nvjitlink-cu12==12.4.127; platform_system == 'Linux' and platform_machine == 'x86_64'" ), "12.6": ( "nvidia-cuda-nvrtc-cu12==12.6.77; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cuda-runtime-cu12==12.6.77; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cuda-cupti-cu12==12.6.80; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cudnn-cu12==9.5.1.17; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cublas-cu12==12.6.4.1; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cufft-cu12==11.3.0.4; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-curand-cu12==10.3.7.77; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusolver-cu12==11.7.1.2; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusparse-cu12==12.5.4.2; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusparselt-cu12==0.6.3; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nccl-cu12==2.25.1; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nvtx-cu12==12.6.77; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nvjitlink-cu12==12.6.85; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cufile-cu12==1.11.1.6; platform_system == 'Linux' and platform_machine == 'x86_64'" ), "12.8": ( "nvidia-cuda-nvrtc-cu12==12.8.61; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cuda-runtime-cu12==12.8.57; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cuda-cupti-cu12==12.8.57; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cudnn-cu12==9.7.1.26; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cublas-cu12==12.8.3.14; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cufft-cu12==11.3.3.41; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-curand-cu12==10.3.9.55; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusolver-cu12==11.7.2.55; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusparse-cu12==12.5.7.53; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cusparselt-cu12==0.6.3; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nccl-cu12==2.25.1; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nvtx-cu12==12.8.55; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-nvjitlink-cu12==12.8.61; platform_system == 'Linux' and platform_machine == 'x86_64' | " "nvidia-cufile-cu12==1.13.0.11; platform_system == 'Linux' and platform_machine == 'x86_64'" ), "xpu": ( "intel-cmplr-lib-rt==2025.0.2 | " "intel-cmplr-lib-ur==2025.0.2 | " "intel-cmplr-lic-rt==2025.0.2 | " "intel-sycl-rt==2025.0.2 | " "tcmlib==1.2.0 | " "umf==0.9.1 | " "intel-pti==0.10.0" ), } def get_nccl_wheel_version(arch_version: str) -> str: import re requirements = map( str.strip, re.split("[;|]", PYTORCH_EXTRA_INSTALL_REQUIREMENTS[arch_version]) ) return next(x for x in requirements if x.startswith("nvidia-nccl-cu")).split("==")[ 1 ] def read_nccl_pin(arch_version: str) -> str: from pathlib import Path nccl_pin_path = os.path.join( Path(__file__).absolute().parents[2], ".ci", "docker", "ci_commit_pins", f"nccl-cu{arch_version[:2]}.txt", ) with open(nccl_pin_path) as f: return f.read().strip() def validate_nccl_dep_consistency(arch_version: str) -> None: nccl_release_tag = read_nccl_pin(arch_version) wheel_ver = get_nccl_wheel_version(arch_version) if not nccl_release_tag.startswith(f"v{wheel_ver}"): raise RuntimeError( f"{arch_version} NCCL release tag version {nccl_release_tag} does not correspond to wheel version {wheel_ver}" ) def arch_type(arch_version: str) -> str: if arch_version in CUDA_ARCHES: return "cuda" elif arch_version in ROCM_ARCHES: return "rocm" elif arch_version in XPU_ARCHES: return "xpu" elif arch_version in CPU_CXX11_ABI_ARCH: return "cpu-cxx11-abi" elif arch_version in CPU_AARCH64_ARCH: return "cpu-aarch64" elif arch_version in CPU_S390X_ARCH: return "cpu-s390x" elif arch_version in CUDA_AARCH64_ARCHES: return "cuda-aarch64" else: # arch_version should always be "cpu" in this case return "cpu" # This can be updated to the release version when cutting release branch, i.e. 2.1 DEFAULT_TAG = os.getenv("RELEASE_VERSION_TAG", "main") WHEEL_CONTAINER_IMAGES = { **{ gpu_arch: f"pytorch/manylinux2_28-builder:cuda{gpu_arch}-{DEFAULT_TAG}" for gpu_arch in CUDA_ARCHES }, **{ gpu_arch: f"pytorch/manylinuxaarch64-builder:cuda{gpu_arch.replace('-aarch64', '')}-{DEFAULT_TAG}" for gpu_arch in CUDA_AARCH64_ARCHES }, **{ gpu_arch: f"pytorch/manylinux2_28-builder:rocm{gpu_arch}-{DEFAULT_TAG}" for gpu_arch in ROCM_ARCHES }, "xpu": f"pytorch/manylinux2_28-builder:xpu-{DEFAULT_TAG}", "cpu": f"pytorch/manylinux2_28-builder:cpu-{DEFAULT_TAG}", "cpu-cxx11-abi": f"pytorch/manylinuxcxx11-abi-builder:cpu-cxx11-abi-{DEFAULT_TAG}", "cpu-aarch64": f"pytorch/manylinux2_28_aarch64-builder:cpu-aarch64-{DEFAULT_TAG}", "cpu-s390x": f"pytorch/manylinuxs390x-builder:cpu-s390x-{DEFAULT_TAG}", } CXX11_ABI = "cxx11-abi" RELEASE = "release" DEBUG = "debug" LIBTORCH_CONTAINER_IMAGES: dict[tuple[str, str], str] = { **{ ( gpu_arch, CXX11_ABI, ): f"pytorch/libtorch-cxx11-builder:cuda{gpu_arch}-{DEFAULT_TAG}" for gpu_arch in CUDA_ARCHES }, **{ ( gpu_arch, CXX11_ABI, ): f"pytorch/libtorch-cxx11-builder:rocm{gpu_arch}-{DEFAULT_TAG}" for gpu_arch in ROCM_ARCHES }, ("cpu", CXX11_ABI): f"pytorch/libtorch-cxx11-builder:cpu-{DEFAULT_TAG}", } FULL_PYTHON_VERSIONS = ["3.9", "3.10", "3.11", "3.12", "3.13", "3.13t"] def translate_desired_cuda(gpu_arch_type: str, gpu_arch_version: str) -> str: return { "cpu": "cpu", "cpu-aarch64": "cpu", "cpu-cxx11-abi": "cpu-cxx11-abi", "cpu-s390x": "cpu", "cuda": f"cu{gpu_arch_version.replace('.', '')}", "cuda-aarch64": f"cu{gpu_arch_version.replace('-aarch64', '').replace('.', '')}", "rocm": f"rocm{gpu_arch_version}", "xpu": "xpu", }.get(gpu_arch_type, gpu_arch_version) def list_without(in_list: list[str], without: list[str]) -> list[str]: return [item for item in in_list if item not in without] def generate_libtorch_matrix( os: str, abi_version: str, arches: Optional[list[str]] = None, libtorch_variants: Optional[list[str]] = None, ) -> list[dict[str, str]]: if arches is None: arches = ["cpu"] if os == "linux": arches += CUDA_ARCHES arches += ROCM_ARCHES # skip CUDA 12.8 builds for libtorch if "12.8" in arches: arches.remove("12.8") elif os == "windows": arches += CUDA_ARCHES # skip CUDA 12.8 builds on Windows if "12.8" in arches: arches.remove("12.8") if libtorch_variants is None: libtorch_variants = [ "shared-with-deps", "shared-without-deps", "static-with-deps", "static-without-deps", ] ret: list[dict[str, str]] = [] for arch_version in arches: for libtorch_variant in libtorch_variants: # one of the values in the following list must be exactly # CXX11_ABI, but the precise value of the other one doesn't # matter gpu_arch_type = arch_type(arch_version) gpu_arch_version = "" if arch_version == "cpu" else arch_version # ROCm builds without-deps failed even in ROCm runners; skip for now if gpu_arch_type == "rocm" and ("without-deps" in libtorch_variant): continue ret.append( { "gpu_arch_type": gpu_arch_type, "gpu_arch_version": gpu_arch_version, "desired_cuda": translate_desired_cuda( gpu_arch_type, gpu_arch_version ), "libtorch_variant": libtorch_variant, "libtorch_config": abi_version if os == "windows" else "", "devtoolset": abi_version if os != "windows" else "", "container_image": ( LIBTORCH_CONTAINER_IMAGES[(arch_version, abi_version)] if os != "windows" else "" ), "package_type": "libtorch", "build_name": f"libtorch-{gpu_arch_type}{gpu_arch_version}-{libtorch_variant}-{abi_version}".replace( ".", "_" ), } ) return ret def generate_wheels_matrix( os: str, arches: Optional[list[str]] = None, python_versions: Optional[list[str]] = None, use_split_build: bool = False, ) -> list[dict[str, str]]: package_type = "wheel" if os == "linux" or os == "linux-aarch64" or os == "linux-s390x": # NOTE: We only build manywheel packages for x86_64 and aarch64 and s390x linux package_type = "manywheel" if python_versions is None: python_versions = FULL_PYTHON_VERSIONS if arches is None: # Define default compute archivectures arches = ["cpu"] if os == "linux": arches += CPU_CXX11_ABI_ARCH + CUDA_ARCHES + ROCM_ARCHES + XPU_ARCHES elif os == "windows": arches += CUDA_ARCHES + XPU_ARCHES # skip CUDA 12.8 builds on Windows until available if "12.8" in arches: arches.remove("12.8") elif os == "linux-aarch64": # Separate new if as the CPU type is different and # uses different build/test scripts arches = CPU_AARCH64_ARCH + CUDA_AARCH64_ARCHES elif os == "linux-s390x": # Only want the one arch as the CPU type is different and # uses different build/test scripts arches = ["cpu-s390x"] ret: list[dict[str, str]] = [] for python_version in python_versions: for arch_version in arches: gpu_arch_type = arch_type(arch_version) gpu_arch_version = ( "" if arch_version == "cpu" or arch_version == "cpu-cxx11-abi" or arch_version == "cpu-aarch64" or arch_version == "cpu-s390x" or arch_version == "xpu" else arch_version ) # TODO: Enable python 3.13t on cpu-s390x if gpu_arch_type == "cpu-s390x" and python_version == "3.13t": continue if use_split_build and ( arch_version not in ["12.6", "12.4", "11.8", "cpu"] or os != "linux" ): raise RuntimeError( "Split build is only supported on linux with cuda 12*, 11.8, and cpu.\n" f"Currently attempting to build on arch version {arch_version} and os {os}.\n" "Please modify the matrix generation to exclude this combination." ) # cuda linux wheels require PYTORCH_EXTRA_INSTALL_REQUIREMENTS to install if ( arch_version in ["12.8", "12.6", "12.4", "11.8"] and os == "linux" or arch_version in CUDA_AARCH64_ARCHES ): ret.append( { "python_version": python_version, "gpu_arch_type": gpu_arch_type, "gpu_arch_version": gpu_arch_version, "desired_cuda": translate_desired_cuda( gpu_arch_type, gpu_arch_version ), "use_split_build": "True" if use_split_build else "False", "devtoolset": "cxx11-abi", "container_image": WHEEL_CONTAINER_IMAGES[arch_version], "package_type": package_type, "pytorch_extra_install_requirements": ( PYTORCH_EXTRA_INSTALL_REQUIREMENTS[arch_version] if os != "linux-aarch64" else "" ), "build_name": ( f"{package_type}-py{python_version}-{gpu_arch_type}" f"{'-' if 'aarch64' in gpu_arch_type else ''}{gpu_arch_version.replace('-aarch64', '')}".replace( ".", "_" ) ), # include special case for aarch64 build, remove the -aarch64 postfix } ) # Special build building to use on Colab. Python 3.11 for 12.4 CUDA if python_version == "3.11" and arch_version == "12.4": ret.append( { "python_version": python_version, "gpu_arch_type": gpu_arch_type, "gpu_arch_version": gpu_arch_version, "desired_cuda": translate_desired_cuda( gpu_arch_type, gpu_arch_version ), "use_split_build": "True" if use_split_build else "False", "devtoolset": "", "container_image": WHEEL_CONTAINER_IMAGES[arch_version], "package_type": package_type, "pytorch_extra_install_requirements": "", "build_name": f"{package_type}-py{python_version}-{gpu_arch_type}{gpu_arch_version}-full".replace( # noqa: B950 ".", "_" ), } ) else: ret.append( { "python_version": python_version, "gpu_arch_type": gpu_arch_type, "gpu_arch_version": gpu_arch_version, "desired_cuda": translate_desired_cuda( gpu_arch_type, gpu_arch_version ), "use_split_build": "True" if use_split_build else "False", "devtoolset": ( "cxx11-abi" if (arch_version in ["cpu-cxx11-abi", "cpu-aarch64"]) or os == "linux" else "" ), "container_image": WHEEL_CONTAINER_IMAGES[arch_version], "package_type": package_type, "build_name": f"{package_type}-py{python_version}-{gpu_arch_type}{gpu_arch_version}".replace( ".", "_" ), "pytorch_extra_install_requirements": ( PYTORCH_EXTRA_INSTALL_REQUIREMENTS["xpu"] if gpu_arch_type == "xpu" else PYTORCH_EXTRA_INSTALL_REQUIREMENTS["12.4"] if os != "linux" else "" ), } ) return ret validate_nccl_dep_consistency("12.8") validate_nccl_dep_consistency("12.6") validate_nccl_dep_consistency("12.4") validate_nccl_dep_consistency("11.8")