Support pre-built wheels for Python 3.14

[bharat-thotakura]

Required prerequisites

• Search the issue tracker to check if your feature has already been mentioned or rejected in other issues.

Describe the feature

With the expected release of Python 3.15 soon (Oct 2026), and active support end at the same time for Python 3.13, it would be great for cudaq to be directly supported on Python 3.14. Currently, trying the following:

python3.14 -m venv .venv
source .venv/bin/activate
python3 -m pip install -U pip
pip install cudaq

yields:

WARNING: Cache entry deserialization failed, entry ignored
Collecting cudaq
  Using cached cudaq-0.14.2.tar.gz (10.0 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
WARNING: Cache entry deserialization failed, entry ignored
INFO: pip is looking at multiple versions of cudaq to determine which version is compatible with other requirements. This could take a while.
  Using cached cudaq-0.14.0.tar.gz (10.0 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
  Using cached cudaq-0.13.0.tar.gz (9.2 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
  Using cached cudaq-0.12.0.post1.tar.gz (9.2 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... error
  error: subprocess-exited-with-error

  × Getting requirements to build wheel did not run successfully.
  │ exit code: 1
  ╰─> [52 lines of output]
      [cudaq] Looking for existing installation of cuda-quantum.
      [cudaq] User site-packages directory does not exist.
      [cudaq] Global site-packages directories: ['/home/user/dev/.venv/lib/python3.14/site-packages', '/home/user/dev/.venv/local/lib/python3.14/dist-packages', '/home/user/dev/.venv/lib/python3/dist-packages', '/home/user/dev/.venv/lib/python3.14/dist-packages']
      [cudaq] No matches found for 'cuda_quantum' in any site-packages directory.
      [cudaq] Looking for existing installation of cuda-quantum-cu11.
      [cudaq] User site-packages directory does not exist.
      [cudaq] Global site-packages directories: ['/home/user/dev/.venv/lib/python3.14/site-packages', '/home/user/dev/.venv/local/lib/python3.14/dist-packages', '/home/user/dev/.venv/lib/python3/dist-packages', '/home/user/dev/.venv/lib/python3.14/dist-packages']
      [cudaq] No matches found for 'cuda_quantum_cu11' in any site-packages directory.
      [cudaq] Looking for existing installation of cuda-quantum-cu12.
      [cudaq] User site-packages directory does not exist.
      [cudaq] Global site-packages directories: ['/home/user/dev/.venv/lib/python3.14/site-packages', '/home/user/dev/.venv/local/lib/python3.14/dist-packages', '/home/user/dev/.venv/lib/python3/dist-packages', '/home/user/dev/.venv/lib/python3.14/dist-packages']
      [cudaq] No matches found for 'cuda_quantum_cu12' in any site-packages directory.
      [cudaq] Trying to detect CUDA version from libraries: ['libnvrtc.so.12', 'libnvrtc.so.11.2', 'libnvrtc.so.11.1', 'libnvrtc.so.11.0']
      [cudaq] Looking for library: libnvrtc.so.12
      [cudaq] Failed to open libnvrtc.so.12: libnvrtc.so.12: cannot open shared object file: No such file or directory
      [cudaq] Looking for library: libnvrtc.so.11.2
      [cudaq] Failed to open libnvrtc.so.11.2: libnvrtc.so.11.2: cannot open shared object file: No such file or directory
      [cudaq] Looking for library: libnvrtc.so.11.1
      [cudaq] Failed to open libnvrtc.so.11.1: libnvrtc.so.11.1: cannot open shared object file: No such file or directory
      [cudaq] Looking for library: libnvrtc.so.11.0
      [cudaq] Failed to open libnvrtc.so.11.0: libnvrtc.so.11.0: cannot open shared object file: No such file or directory
      [cudaq] No more candidate library to find
      [cudaq] Trying to detect CUDA version from libraries: ['libcudart.so.12', 'libcudart.so.11.0']
      [cudaq] Looking for library: libcudart.so.12
      [cudaq] Failed to open libcudart.so.12: libcudart.so.12: cannot open shared object file: No such file or directory
      [cudaq] Looking for library: libcudart.so.11.0
      [cudaq] Failed to open libcudart.so.11.0: libcudart.so.11.0: cannot open shared object file: No such file or directory
      [cudaq] No more candidate library to find
      [cudaq] Trying to detect CUDA version using NVIDIA Management Library
      [cudaq] Detected version: 13020
      [cudaq] Autodetection succeeded
      Traceback (most recent call last):
        File "/home/user/dev/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 389, in <module>
          main()
          ~~~~^^
        File "/home/user/dev/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 373, in main
          json_out["return_val"] = hook(**hook_input["kwargs"])
                                   ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
        File "/home/user/dev/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 143, in get_requires_for_build_wheel
          return hook(config_settings)
        File "/tmp/pip-build-env-ry6ame_y/overlay/lib/python3.14/site-packages/setuptools/build_meta.py", line 333, in get_requires_for_build_wheel
          return self._get_build_requires(config_settings, requirements=[])
                 ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/tmp/pip-build-env-ry6ame_y/overlay/lib/python3.14/site-packages/setuptools/build_meta.py", line 301, in _get_build_requires
          self.run_setup()
          ~~~~~~~~~~~~~~^^
        File "/tmp/pip-build-env-ry6ame_y/overlay/lib/python3.14/site-packages/setuptools/build_meta.py", line 317, in run_setup
          exec(code, locals())
          ~~~~^^^^^^^^^^^^^^^^
        File "<string>", line 243, in <module>
        File "<string>", line 201, in _infer_best_package
      Exception: Your CUDA version (13020) is too new.
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed to build 'cudaq' when getting requirements to build wheel

For context, the install was against CUDA Version: 13.2

[acosmicflamingo]

Just asked whether there are any blockers here. It looks like there a moment earlier this year to add support, but upstream dependencies like CuPy had not added support for Python 3.14 at the time. I think the dust has settled and it could now be possible, but anyone on the cuda-quantum team can correct me if I'm wrong.

[aminx-hue]

We have this scheduled for a coming release

[acosmicflamingo]

Nice!