dependencies.yaml

# SPDX-FileCopyrightText: Copyright (c) 2023-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

# Dependency list for https://github.com/rapidsai/dependency-file-generator

files:
  all:
    output: conda
    matrix:
      cuda: ["12.9", "13.3"]
      arch: [x86_64, aarch64]
    includes:
      - build_common
      - build_cpp
      - build_wheels
      - build_python_common
      - cuda
      - cuda_version
      - develop
      - py_version
      - docs
      - notebooks
      - py_version
      - run_common
      - run_cuopt
      - run_cuopt_server
      - run_cuopt_sh_client
      - test_cpp
      - test_python_common
      - test_python_cuopt
      - test_python_cuopt_server
      - depends_on_cudf
      - depends_on_cupy
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_pylibraft
      - depends_on_rapids_logger
      - depends_on_rmm
      - rapids_build_backend
  # Installs libcuopt-client alone. A component that quietly needs another
  # engine fails to resolve or to load here, where every other test environment
  # pulls the whole graph through the libcuopt metapackage and hides it.
  test_libcuopt_client:
    output: none
    includes:
      - cuda_version
      - depends_on_libcuopt_client
  # Installs libcuopt-mathopt alone. A component that quietly needs another
  # engine fails to resolve or to load here, where every other test environment
  # pulls the whole graph through the libcuopt metapackage and hides it.
  test_libcuopt_mathopt:
    output: none
    includes:
      - cuda_version
      - depends_on_libcuopt_mathopt
  # Installs libcuopt-routing alone. A component that quietly needs another
  # engine fails to resolve or to load here, where every other test environment
  # pulls the whole graph through the libcuopt metapackage and hides it.
  test_libcuopt_routing:
    output: none
    includes:
      - cuda_version
      - depends_on_libcuopt_routing
  test_cpp:
    output: none
    includes:
      - cuda
      - cuda_version
      - test_cpp
      - test_cpp_cuopt
      - depends_on_libcuopt
  # The static Java build compiles libcuopt from source, so it only needs the prebuilt rmm and
  # rapids_logger wheels (and the build tools), not the libcuopt-* wheels.
  java_static:
    output: none
    includes:
      - build_common
      - depends_on_librmm
      - depends_on_rapids_logger
  java:
    output: none
    includes:
      - build_common
      - cuda
      - cuda_version
      - depends_on_libcuopt
      # The JNI layer compiles against libcuopt's public headers, which include
      # raft, rmm and rapids_logger headers transitively.
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_rapids_logger
      - java
  test_python:
    output: none
    includes:
      - cuda_version
      - py_version
      - depends_on_libcuopt
      - depends_on_cuopt
      - depends_on_cuopt_server
      - depends_on_cuopt_sh_client
      - test_python_common
      - test_python_cuopt
      - test_python_cuopt_server
  test_notebooks:
    output: none
    includes:
      - cuda_version
      - notebooks
      - py_version
      - depends_on_cuopt_server
      - depends_on_cuopt_sh_client
  checks:
    output: none
    includes:
      - develop
      - py_version
  docs:
    output: none
    includes:
      - cuda
      - cuda_version
      - depends_on_libcuopt
      - depends_on_cuopt
      - depends_on_cuopt_server
      - depends_on_cuopt_sh_client
      - docs
      - py_version
  py_build_libcuopt:
    output: pyproject
    pyproject_dir: python/libcuopt
    extras:
      table: build-system
    includes:
      - rapids_build_backend
  py_rapids_build_libcuopt:
    output: pyproject
    pyproject_dir: python/libcuopt
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: tool.rapids-build-backend
      key: requires
    includes:
      - build_common
      - depends_on_libcuopt_client
      - depends_on_libcuopt_mathopt
      - depends_on_libcuopt_routing
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_rapids_logger
  # Thin metapackage: depends on the three component wheels instead of bundling them.
  py_run_libcuopt:
    output: pyproject
    pyproject_dir: python/libcuopt
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: project
    includes:
      - depends_on_libcuopt_client
      - depends_on_libcuopt_mathopt
      - depends_on_libcuopt_routing
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_rapids_logger
  # One set of keys per component wheel. The point of the split is in py_run_*:
  # only mathopt carries cudss / nccl / nvjitlink, so a routing-only install no
  # longer pulls libraries it never calls.
  py_build_libcuopt_client:
    output: pyproject
    pyproject_dir: python/libcuopt_client
    extras:
      table: build-system
    includes:
      - rapids_build_backend
  py_rapids_build_libcuopt_client:
    output: pyproject
    pyproject_dir: python/libcuopt_client
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: tool.rapids-build-backend
      key: requires
    includes:
      - build_common
      - depends_on_librmm
      - depends_on_rapids_logger
  # The client links no CUDA and no rmm, so rapids-logger is its only runtime dependency.
  py_run_libcuopt_client:
    output: pyproject
    pyproject_dir: python/libcuopt_client
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["false"]
    extras:
      table: project
    includes:
      - depends_on_rapids_logger
  py_build_libcuopt_mathopt:
    output: pyproject
    pyproject_dir: python/libcuopt_mathopt
    extras:
      table: build-system
    includes:
      - rapids_build_backend
  py_rapids_build_libcuopt_mathopt:
    output: pyproject
    pyproject_dir: python/libcuopt_mathopt
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: tool.rapids-build-backend
      key: requires
    includes:
      - build_common
      - depends_on_libcuopt_client
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_rapids_logger
  py_run_libcuopt_mathopt:
    output: pyproject
    pyproject_dir: python/libcuopt_mathopt
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: project
    includes:
      - cuda_wheels
      - depends_on_libcuopt_client
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_rapids_logger
  py_build_libcuopt_routing:
    output: pyproject
    pyproject_dir: python/libcuopt_routing
    extras:
      table: build-system
    includes:
      - rapids_build_backend
  py_rapids_build_libcuopt_routing:
    output: pyproject
    pyproject_dir: python/libcuopt_routing
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: tool.rapids-build-backend
      key: requires
    includes:
      - build_common
      - depends_on_libcuopt_client
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_rapids_logger
  py_run_libcuopt_routing:
    output: pyproject
    pyproject_dir: python/libcuopt_routing
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: project
    includes:
      - cuda_wheels_routing
      - depends_on_libcuopt_client
      - depends_on_libraft_headers
      - depends_on_librmm
      - depends_on_rapids_logger
  py_build_cuopt:
    output: pyproject
    pyproject_dir: python/cuopt
    extras:
      table: build-system
    includes:
      - rapids_build_backend
  py_rapids_build_cuopt:
    output: pyproject
    pyproject_dir: python/cuopt
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: tool.rapids-build-backend
      key: requires
    includes:
      - build_common
      - build_python_common
      - depends_on_libcuopt
      # needed for find_package(cuopt) to resolve cuopt::client/mathopt/routing
      - depends_on_libcuopt_client
      - depends_on_libcuopt_mathopt
      - depends_on_libcuopt_routing
      - depends_on_rapids_logger
      - depends_on_cupy
      - depends_on_pylibraft
      - depends_on_rmm
  py_run_cuopt:
    output: pyproject
    pyproject_dir: python/cuopt
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: project
    includes:
      - run_common
      - run_cuopt
      - depends_on_cupy
      - depends_on_libcuopt
      - depends_on_rmm
      - depends_on_cudf
      - depends_on_pylibraft
      - depends_on_rapids_logger
  py_test_cuopt:
    output: pyproject
    pyproject_dir: python/cuopt
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: project.optional-dependencies
      key: test
    includes:
      - test_python_common
      - test_python_cuopt
      - depends_on_rapids_logger
      - test_cufile
  py_build_cuopt_server:
    output: pyproject
    pyproject_dir: python/cuopt_server
    extras:
      table: build-system
    includes:
      - rapids_build_setuptools
      - build_wheels
  py_test_cuopt_server:
    output: pyproject
    pyproject_dir: python/cuopt_server
    extras:
      table: project.optional-dependencies
      key: test
    includes:
      - test_python_common
      - test_python_cuopt_server
  py_run_cuopt_server:
    output: pyproject
    pyproject_dir: python/cuopt_server
    matrix:
      cuda_suffixed: ["false"]
      use_cuda_wheels: ["true"]
    extras:
      table: project
    includes:
      - run_common
      - run_cuopt_server
      - depends_on_cupy
      - depends_on_cuopt
  py_build_cuopt_sh_client:
    output: pyproject
    pyproject_dir: python/cuopt_self_hosted/
    extras:
      table: build-system
    includes:
      - build_wheels
  py_test_cuopt_sh_client:
    output: pyproject
    pyproject_dir: python/cuopt_self_hosted/
    extras:
      table: project.optional-dependencies
      key: test
    includes:
      - test_python_common
  py_run_cuopt_sh_client:
    output: pyproject
    pyproject_dir: python/cuopt_self_hosted/
    extras:
      table: project
    includes:
      - run_cuopt_sh_client
  py_mps_cuopt_sh_client:
    output: pyproject
    pyproject_dir: python/cuopt_self_hosted/
    extras:
      table: project.optional-dependencies
      key: mps
    includes:
      - mps_cuopt_sh_client
  py_build_cuopt_mcp:
    output: pyproject
    pyproject_dir: python/cuopt_mcp/
    extras:
      table: build-system
    includes:
      - build_wheels
  py_run_cuopt_mcp:
    output: pyproject
    pyproject_dir: python/cuopt_mcp/
    matrix:
      cuda_suffixed: ["false"]
    extras:
      table: project
    includes:
      - run_cuopt_mcp
      - depends_on_cuopt
  py_test_cuopt_mcp:
    output: pyproject
    pyproject_dir: python/cuopt_mcp/
    extras:
      table: project.optional-dependencies
      key: test
    includes:
      - test_python_common
channels:
  - rapidsai-nightly
  - rapidsai
  - conda-forge
dependencies:
  rapids_build_backend:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - &rapids_build_backend rapids-build-backend>=0.4.0,<0.5.0
      - output_types: [conda, constraints]
        packages:
          - scikit-build-core>=0.11.0
      - output_types: [requirements, pyproject]
        packages:
          - scikit-build-core[pyproject]>=0.11.0
  rapids_build_setuptools:
    common:
      - output_types: [requirements, constraints, pyproject]
        packages:
          - *rapids_build_backend
          - setuptools>=77.0.0
          - wheel
  build_common:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - cmake>=4.0
          - ninja
      - output_types: conda
        packages:
          - c-compiler
          - cuda-nvcc
          - cxx-compiler
          - ccache
    specific:
      - output_types: conda
        matrices:
          - matrix:
              arch: x86_64
            packages:
              - gcc_linux-64=14.*
              - sysroot_linux-64==2.28
          - matrix:
              arch: aarch64
            packages:
              - gcc_linux-aarch64=14.*
              - sysroot_linux-aarch64==2.28
  build_cpp:
    common:
      - output_types: conda
        packages:
          - libboost-devel
          - cpp-argparse
          - &pyyaml pyyaml>=6.0.0
          - nccl >=2.19
          - tbb-devel
          - zlib
          - bzip2
          - openssl
          - c-ares
          - libgrpc >=1.78.0,<1.80.0a0
          - libprotobuf
          - libabseil
          - re2
  java:
    common:
      - output_types: conda
        packages:
          - maven
          - openjdk=17.*
  test_cpp:
    common:
      - output_types: [conda]
        packages:
          - cuda-sanitizer-api
          - *pyyaml
  test_cpp_cuopt:
    common:
      - output_types: [conda]
        packages:
          - libcuopt-tests==26.12.*,>=0.0.0a0
  build_wheels:
    common:
      - output_types: [requirements, constraints, pyproject]
        packages:
          - wheel
          - setuptools>=77.0.0
  run_common:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - &numpy numpy>=2.0,<3.0
  build_python_common:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - cython>=3.2.2,<3.3.0a0
  test_python_common:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - pytest<9.0
          - pytest-cov
          - pytest-rerunfailures
          - pytest-xdist
    specific:
      - output_types: [conda, requirements, constraints, pyproject]
        matrices:
          - matrix:
              dependencies: "oldest"
            packages:
              - numba-cuda==0.30.2
              - numpy==2.0.*
          - matrix:
            packages:
  test_python_cuopt:
    common:
      - output_types: [conda]
        packages:
          - *numpy
      - output_types: [requirements, constraints, pyproject]
        packages:
          - *numpy
  run_cuopt:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - numba-cuda>=0.22.1
          - numba>=0.60.0,<0.65.0
          - &pandas pandas>=2.0
          - *pyyaml
          - scipy>=1.14.1

  test_python_cuopt_server:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - &jsonref jsonref==1.1.0
          - &msgpack_numpy msgpack-numpy==0.4.8
          - pexpect
          - &requests requests
      - output_types: [requirements, constraints, pyproject]
        packages:
          - &msgpack msgpack==1.2.3
      - output_types: conda
        packages:
          - &msgpack_python msgpack-python==1.2.3

  run_cuopt_server:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - fastapi
          - *jsonref
          - *msgpack_numpy
          - *pandas
          - psutil>=6.0.0
          - uvicorn==0.34.*
      - output_types: conda
        packages:
          - *msgpack_python
          - pip
      - output_types: [requirements, constraints, pyproject]
        packages:
          - *msgpack

  run_cuopt_mcp:
    # cuopt itself comes from depends_on_cuopt (CUDA-suffixed on PyPI).
    # cuopt_mcp imports it lazily so the MCP handshake stays fast, which
    # means an undeclared dependency would only surface on the first tool
    # call rather than at install time.
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - mcp>=2.0
      - output_types: conda
        packages:
          - pip

  run_cuopt_sh_client:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - *msgpack_numpy
          - *requests
      - output_types: conda
        packages:
          - *msgpack_python
          - pip
      - output_types: [requirements, constraints, pyproject]
        packages:
          - *msgpack
  mps_cuopt_sh_client:
    # Optional dependency exposed as the `cuopt-sh-client[mps]` extra.
    # cuopt-sh-client itself is a CUDA-free thin client, but the MPS
    # parser ships inside cuopt, which on PyPI only exists as the
    # CUDA-suffixed cuopt-cu12 / cuopt-cu13 wheels. Those two cannot
    # coexist (both install to the same `cuopt/` directory), so a user
    # who already has cuopt-cu12 installed should NOT pull this extra
    # and should pip-install cuopt-cu12 manually instead.
    common:
      - output_types: [requirements, constraints, pyproject]
        packages:
          - cuopt-cu13==26.12.*,>=0.0.0a0
  # One unsuffixed libcuopt-client, for every CUDA version and every output type.
  depends_on_libcuopt_client:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - libcuopt-client==26.12.*,>=0.0.0a0
  depends_on_libcuopt_mathopt:
    common:
      - output_types: conda
        packages:
          - &libcuopt_mathopt_unsuffixed libcuopt-mathopt==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - libcuopt-mathopt-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - libcuopt-mathopt-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *libcuopt_mathopt_unsuffixed
  depends_on_libcuopt_routing:
    common:
      - output_types: conda
        packages:
          - &libcuopt_routing_unsuffixed libcuopt-routing==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - libcuopt-routing-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - libcuopt-routing-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *libcuopt_routing_unsuffixed
  depends_on_libcuopt:
    common:
      - output_types: conda
        packages:
          - &libcuopt_unsuffixed libcuopt==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - libcuopt-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - libcuopt-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *libcuopt_unsuffixed
  depends_on_cuopt:
    common:
      - output_types: conda
        packages:
          - &cuopt_unsuffixed cuopt==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - cuopt-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - cuopt-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *cuopt_unsuffixed
  depends_on_cuopt_server:
    common:
      - output_types: conda
        packages:
          - &cuopt_server_unsuffixed cuopt-server==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - cuopt-server-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - cuopt-server-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *cuopt_server_unsuffixed
  depends_on_cuopt_sh_client:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - cuopt-sh-client==26.12.*,>=0.0.0a0
  # cuopt/routing/data_model_view.hpp is a public header and includes raft/core/handle.hpp
  # and raft/core/device_span.hpp, so anything compiling against cuOpt needs raft's headers.
  # The wheel that carries them is named libraft; the conda package is libraft-headers.
  depends_on_libraft_headers:
    common:
      - output_types: conda
        packages:
          - libraft-headers==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - libraft-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - libraft-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - libraft==26.12.*,>=0.0.0a0
  depends_on_librmm:
    common:
      - output_types: conda
        packages:
          - &librmm_unsuffixed librmm==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - librmm-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - librmm-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *librmm_unsuffixed
  depends_on_cupy:
    common:
      - output_types: conda
        packages:
          - cupy>=14.0.1,!=14.1.0
    # NOTE: This is intentionally not broken into groups by a 'cuda_suffixed' selector like
    #       other packages with -cu{nn}x suffixes in this file.
    #       All RAPIDS wheel builds (including in devcontainers) expect cupy to be suffixed.
    specific:
      - output_types: constraints
        matrices:
          - matrix:
              cuda: "12.*"
            packages:
              - &cupy_cu12 cupy-cuda12x>=14.0.1,!=14.1.0
          # fallback to CUDA 13 versions if 'cuda' is '13.*' or not provided
          - matrix:
            packages:
              - &cupy_cu13 cupy-cuda13x>=14.0.1,!=14.1.0
      - output_types: [requirements, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              use_cuda_wheels: "false"
            packages:
              - *cupy_cu12
          - matrix:
              cuda: "13.*"
              use_cuda_wheels: "false"
            packages:
              - *cupy_cu13
          - matrix:
              cuda: "12.*"
              use_cuda_wheels: "true"
            packages:
              - cupy-cuda12x[ctk]>=14.0.1,!=14.1.0
          # fallback to CUDA 13 versions if 'cuda' is '13.*' or not provided
          - matrix:
              use_cuda_wheels: "true"
            packages:
              - cupy-cuda13x[ctk]>=14.0.1,!=14.1.0
  depends_on_rapids_logger:
    common:
      - output_types: [conda, requirements, constraints, pyproject]
        packages:
          - rapids-logger==0.3.*
  depends_on_rmm:
    common:
      - output_types: conda
        packages:
          - &rmm_unsuffixed rmm==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - rmm-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - rmm-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *rmm_unsuffixed

  depends_on_cudf:
    common:
      - output_types: conda
        packages:
          - &cudf_unsuffixed cudf==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - cudf-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - cudf-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *cudf_unsuffixed

  depends_on_pylibraft:
    common:
      - output_types: conda
        packages:
          - &pylibraft_unsuffixed pylibraft==26.12.*,>=0.0.0a0
    specific:
      - output_types: [requirements, constraints, pyproject]
        matrices:
          - matrix:
              cuda: "12.*"
              cuda_suffixed: "true"
            packages:
              - pylibraft-cu12==26.12.*,>=0.0.0a0
          - matrix:
              cuda: "13.*"
              cuda_suffixed: "true"
            packages:
              - pylibraft-cu13==26.12.*,>=0.0.0a0
          - matrix:
              cuda_suffixed: "false"
            packages:
              - *pylibraft_unsuffixed
  # 'cuda_version' intentionally does not contain fallback entries... we want
  # a loud error if an unsupported 'cuda' value is passed
  cuda_version:
    specific:
      - output_types: conda
        matrices:
          - matrix:
              cuda: "12.2"
            packages:
              - cuda-version=12.2
          - matrix:
              cuda: "12.5"
            packages:
              - cuda-version=12.5
          - matrix:
              cuda: "12.8"
            packages:
              - cuda-version=12.8
          - matrix:
              cuda: "12.9"
            packages:
              - cuda-version=12.9
          - matrix:
              cuda: "13.0"
            packages:
              - cuda-version=13.0
          - matrix:
              cuda: "13.1"
            packages:
              - cuda-version=13.1
          - matrix:
              cuda: "13.2"
            packages:
              - cuda-version=13.2
          - matrix:
              cuda: "13.3"
            packages:
              - cuda-version=13.3
      - output_types: [requirements, constraints]
        matrices:
          # if use_cuda_wheels=false is provided, do not add dependencies on any CUDA wheels
          # (e.g. for DLFW and pip devcontainers)
          - matrix:
              use_cuda_wheels: "false"
            packages:
          - matrix:
              arch: aarch64
              cuda: "12.2"
              use_cuda_wheels: "true"
            packages:
              # some components (like nvidia-cublas-cu12 and nvidia-cuda-nvcc-cu12) didn't have
              # aarch64 wheels until CTK 12.3, so allow a slightly looser bound here
              - cuda-toolkit>=12.2,<12.4
          - matrix:
              cuda: "12.2"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==12.2.*
          - matrix:
              cuda: "12.5"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==12.5.*
          - matrix:
              cuda: "12.8"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==12.8.*
          - matrix:
              cuda: "12.9"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==12.9.*
          - matrix:
              cuda: "13.0"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==13.0.*
          - matrix:
              cuda: "13.1"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==13.1.*
          - matrix:
              cuda: "13.2"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==13.2.*
          - matrix:
              cuda: "13.3"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit==13.3.*
  cuda:
    common:
      - output_types: [conda]
        packages:
          - libcudss-dev >=0.7,<0.8
          - libcusparse-dev
          - cuda-nvtx-dev
          - libnvjitlink-dev
          # omp_fulfill_event@OMP_5.0.1, added in libgomp 11. See ci/utils/install_modern_libgomp.sh
          - libgomp >=11


  # cublas only. libcuopt_routing's DT_NEEDED is cublas, rmm and rapids_logger --
  # it never touches cudss, nccl, cusparse or nvjitlink, so pulling the full
  # cuda_wheels set here would re-create exactly the bloat this split removes.
  cuda_wheels_routing:
    specific:
      - output_types: [requirements, pyproject]
        matrices:
          - matrix:
              use_cuda_wheels: "false"
            packages:
          - matrix:
              cuda: "12.*"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit[cublas,cudart,cusparse]==12.*
              - &nvjitlink_cu12 nvidia-nvjitlink-cu12>=12.9,<13
          - matrix:
              cuda: "13.*"
              use_cuda_wheels: "true"
            packages:
              - &ctk_routing_cu13 cuda-toolkit[cublas,cudart,cusparse]==13.*
              - &nvjitlink_cu13 nvidia-nvjitlink>=13.3,<14
          # No cuda selector: this is what the pyproject file keys resolve against, and it
          # is what populates pyproject.toml in source control. use_cuda_wheels is named
          # explicitly so the entry still reads as a CUDA-wheel set.
          - matrix:
              use_cuda_wheels: "true"
            packages:
              - *ctk_routing_cu13
              - *nvjitlink_cu13
      - output_types: constraints
        matrices:
          - matrix:
              use_cuda_wheels: "false"
            packages:
          - matrix:
              cuda: "12.*"
              use_cuda_wheels: "true"
            packages:
              - &ctk_cu12_constraints cuda-toolkit==12.*
              - *nvjitlink_cu12
          - matrix:
              cuda: "13.*"
              use_cuda_wheels: "true"
            packages:
              - &ctk_cu13_constraints cuda-toolkit==13.*
              - *nvjitlink_cu13
          - matrix:
              use_cuda_wheels: "true"
            packages:
              - *ctk_cu13_constraints
              - *nvjitlink_cu13
  cuda_wheels:
    specific:
      # cuOpt needs 'nvJitLink>={whatever-cuopt-was-built-against}' at runtime, and mixing
      # old-CTK with new-nvJitLink is supported, so maintain 1 entry here per CUDA major.minor
      # cuOpt is built against.
      #
      # nvJitLink has historically roughly followed the CTK's minor versioning scheme,
      # but check at https://docs.nvidia.com/cuda/cuda-toolkit-release-notes/index.html
      - output_types: [requirements, pyproject]
        matrices:
          # if use_cuda_wheels=false is provided, do not add dependencies on any CUDA wheels
          # (e.g. for DLFW and pip devcontainers)
          - matrix:
              use_cuda_wheels: "false"
            packages:
          - matrix:
              cuda: "12.*"
              use_cuda_wheels: "true"
            packages:
              - cuda-toolkit[cublas,cudart,curand,cusolver,cusparse,nvtx]==12.*
              - &cudss_cu12 nvidia-cudss-cu12>=0.7,<0.8
              - &nccl_cu12 nvidia-nccl-cu12>=2.19
              - *nvjitlink_cu12
          - matrix:
              cuda: "13.*"
              use_cuda_wheels: "true"
            packages:
              - &ctk_cu13 cuda-toolkit[cublas,cudart,curand,cusolver,cusparse,nvtx]==13.*
              - &cudss_cu13 nvidia-cudss-cu13>=0.7,<0.8
              - &nccl_cu13 nvidia-nccl-cu13>=2.19
              - *nvjitlink_cu13
          # if no matching matrix selectors passed, list the CUDA 13 requirement
          # (just as a source of documentation, as this populates pyproject.toml in source control)
          - matrix:
              use_cuda_wheels: "true"
            packages:
              - *ctk_cu13
              - *cudss_cu13
              - *nccl_cu13
              - *nvjitlink_cu13
      - output_types: constraints
        matrices:
          - matrix:
              use_cuda_wheels: "false"
            packages:
          - matrix:
              cuda: "12.*"
              use_cuda_wheels: "true"
            packages:
              - *ctk_cu12_constraints
              - *cudss_cu12
              - *nccl_cu12
              - *nvjitlink_cu12
          - matrix:
              cuda: "13.*"
              use_cuda_wheels: "true"
            packages:
              - *ctk_cu13_constraints
              - *cudss_cu13
              - *nccl_cu13
              - *nvjitlink_cu13
          - matrix:
              use_cuda_wheels: "true"
            packages:
              - *ctk_cu13_constraints
              - *cudss_cu13
              - *nccl_cu13
              - *nvjitlink_cu13
  develop:
    common:
      - output_types: [conda, requirements, constraints]
        packages:
          - pre-commit
          - ruamel.yaml>=0.18
      - output_types: conda
        packages:
          - clang==20.1.8
          - clang-tools=20.1.8
          - &doxygen doxygen=1.18.0 # pre-commit hook needs a specific version.
          - vale=3.17.0 # docs prose linter, run by the vale pre-commit hook.
          # Vale parses .rst by shelling out to docutils' rst2html; without it
          # the vale hook fails with "rst2html not found".
          - docutils>=0.21
  docs:
    common:
      - output_types: [conda]
        packages:
          - *doxygen
          - &ipython ipython
          - *jsonref
          - make
          - *msgpack_python
          - *msgpack_numpy
          - myst-parser
          - numpydoc
          - breathe
          - sphinx
          - sphinx-copybutton
          - sphinx-markdown-tables
          - sphinx-design
          - pip:
              - swagger-plugin-for-sphinx
              - nvidia-sphinx-theme

  notebooks:
    common:
      - output_types: [conda, requirements, constraints]
        packages:
          - *ipython
          - notebook
      - output_types: [conda]
        packages:
          - *jsonref
          - *msgpack_numpy
          - *msgpack_python
          - *numpy
      - output_types: [requirements, constraints]
        packages:
          - *numpy
  py_version:
    specific:
      - output_types: conda
        matrices:
          - matrix:
              py: "3.12"
            packages:
              - python=3.12
          - matrix:
              py: "3.13"
            packages:
              - python=3.13
          - matrix:
              py: "3.14"
            packages:
              - python=3.14
          - matrix:
            packages:
              - python>=3.12,<3.15
  test_cufile:
    specific:
      # The `cufile` extra was added to the `cuda-toolkit` metapackage in 12.6.3
      # Adding an explicit test dependency on the cufile package here for
      # testing on versions before 12.6.3
      - output_types: pyproject
        matrices:
          - matrix:
              cuda: "12.[012345]"
              use_cuda_wheels: "true"
            packages:
              - nvidia-cufile-cu12
          - matrix:
            packages: