diff --git a/cuda_core/docs/source/install.rst b/cuda_core/docs/source/install.rst index 33a46a8c84..76e1b923bc 100644 --- a/cuda_core/docs/source/install.rst +++ b/cuda_core/docs/source/install.rst @@ -71,6 +71,32 @@ and likewise use ``cuda-version=13`` for CUDA 13. Note that to use ``cuda.core`` with nvJitLink installed from conda-forge requires ``cuda.bindings`` 12.8.0+. +Installing the latest nightly (top-of-tree builds) +-------------------------------------------------- + +These are useful for users looking to test new features or bug fixes prior to +their inclusion in a release. + +CI publishes wheels as GitHub Actions artifacts on every push to ``main``. To +obtain the most recent build, use the following commands: + +.. code-block:: console + + $ # Find the latest successful CI run on main: + $ RUN_ID=$(gh run list -R NVIDIA/cuda-python -w ci.yml -b main -s success -L1 --json databaseId -q '.[0].databaseId') + + $ # Download the wheel (pick your Python version and platform): + $ gh run download "$RUN_ID" -R NVIDIA/cuda-python -p "cuda-core-python312-linux-64-*" + + $ # Install the downloaded wheel: + $ pip install cuda-core-python312-linux-64-*/cuda_core*.whl[cu13] + +Replace ``python312`` with your Python version (e.g. ``python310``, ``python311``, +``python313``, ``python314``, ``python314t``). For aarch64, replace ``linux-64`` +with ``linux-aarch64``; for Windows, use ``win-64``. Replace ``cu13`` with +``cu12`` for CUDA 12.x environments. + + Development environment -----------------------