Skip to content

Commit 9880432

Browse files
Doc update for container version update and add nvidia-cuda-runtime as dependency (#384)
Adds doc updates for docker container version update Also add nvidia-cuda-runtime as dependency so we don't need to install it explicitly. Authors: - Ramakrishnap (https://github.com/rgsl888prabhu) Approvers: - Cindy Wilkinson (https://github.com/cwilkinson76) - Trevor McKay (https://github.com/tmckayus) URL: #384
1 parent ecf12d2 commit 9880432

File tree

7 files changed

+20
-37
lines changed

7 files changed

+20
-37
lines changed

README.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,6 @@ Development wheels are available as nightlies, please update `--extra-index-url`
7373
pip install --pre \
7474
--extra-index-url=https://pypi.nvidia.com \
7575
--extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
76-
nvidia-cuda-runtime-cu12=12.9.* \
7776
cuopt-server-cu12==25.10.* cuopt-sh-client==25.10.*
7877
```
7978

@@ -82,7 +81,6 @@ For CUDA 13.x:
8281
```bash
8382
pip install \
8483
--extra-index-url=https://pypi.nvidia.com \
85-
nvidia-cuda-runtime==13.0.* \
8684
cuopt-server-cu13==25.10.* cuopt-sh-client==25.10.*
8785
```
8886

@@ -91,7 +89,6 @@ Development wheels are available as nightlies, please update `--extra-index-url`
9189
pip install --pre \
9290
--extra-index-url=https://pypi.nvidia.com \
9391
--extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
94-
nvidia-cuda-runtime==13.0.* \
9592
cuopt-server-cu13==25.10.* cuopt-sh-client==25.10.*
9693
```
9794

@@ -115,13 +112,13 @@ Users can pull the cuOpt container from the NVIDIA container registry.
115112

116113
```bash
117114
# For CUDA 12.x
118-
docker pull nvidia/cuopt:latest-cuda12.9-py312
115+
docker pull nvidia/cuopt:latest-cuda12.9-py3.13
119116

120117
# For CUDA 13.x
121-
docker pull nvidia/cuopt:latest-cuda13.0-py312
118+
docker pull nvidia/cuopt:latest-cuda13.0-py3.13
122119
```
123120

124-
Note: The ``latest`` tag is the latest stable release of cuOpt. If you want to use a specific version, you can use the ``<version>-cuda12.9-py312`` or ``<version>-cuda13.0-py312`` tag. For example, to use cuOpt 25.5.0, you can use the ``25.5.0-cuda12.8-py312`` or ``25.5.0-cuda13.0-py312`` tag. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt>`_ for the list of available tags.
121+
Note: The ``latest`` tag is the latest stable release of cuOpt. If you want to use a specific version, you can use the ``<version>-cuda12.9-py3.13`` or ``<version>-cuda13.0-py3.13`` tag. For example, to use cuOpt 25.10.0, you can use the ``25.10.0-cuda12.9-py3.13`` or ``25.10.0-cuda13.0-py3.13`` tag. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt/tags>`_ for the list of available tags.
125122

126123
More information about the cuOpt container can be found [here](https://docs.nvidia.com/cuopt/user-guide/latest/cuopt-server/quick-start.html#container-from-docker-hub).
127124

ci/docker/Dockerfile

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -62,9 +62,7 @@ RUN \
6262
--extra-index-url https://pypi.anaconda.org/rapidsai-wheels-nightly/simple \
6363
--no-cache-dir \
6464
"cuopt-server-${cuda_suffix}==${CUOPT_VER}" \
65-
"cuopt-sh-client==${CUOPT_VER}" \
66-
"cuda-toolkit[cudart]==${cuda_major_minor}.*" \
67-
${nvidia_cuda_runtime_pkg} && \
65+
"cuopt-sh-client==${CUOPT_VER}" && \
6866
python -m pip list
6967

7068
# Remove gcc to save space, gcc was required for building psutils

dependencies.yaml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -750,12 +750,12 @@ dependencies:
750750
cuda: "12.*"
751751
use_cuda_wheels: "true"
752752
packages:
753-
- cuda-toolkit[cublas,curand,cusolver,cusparse,nvtx]==12.*
753+
- cuda-toolkit[cublas,cudart,curand,cusolver,cusparse,nvtx]==12.*
754754
- matrix:
755755
cuda: "13.*"
756756
use_cuda_wheels: "true"
757757
packages:
758-
- cuda-toolkit[cublas,curand,cusolver,cusparse,nvtx]==13.*
758+
- cuda-toolkit[cublas,cudart,curand,cusolver,cusparse,nvtx]==13.*
759759
# if use_cuda_wheels=false is provided, do not add dependencies on any CUDA wheels
760760
# (e.g. for DLFW and pip devcontainers)
761761
- matrix:
@@ -765,6 +765,7 @@ dependencies:
765765
# (just as a source of documentation, as this populates pyproject.toml in source control)
766766
- matrix:
767767
packages:
768+
- nvidia-cudart
768769
- nvidia-cublas
769770
- nvidia-curand
770771
- nvidia-cusparse

docs/cuopt/source/cuopt-c/quick-start.rst

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,14 +19,10 @@ This wheel is a Python wrapper around the C++ library and eases installation and
1919
pip uninstall cuopt-thin-client
2020
2121
# CUDA 13
22-
pip install --extra-index-url=https://pypi.nvidia.com \
23-
'nvidia-cuda-runtime==13.0.*' \
24-
'libcuopt-cu13==25.10.*'
22+
pip install --extra-index-url=https://pypi.nvidia.com 'libcuopt-cu13==25.10.*'
2523
2624
# CUDA 12
27-
pip install --extra-index-url=https://pypi.nvidia.com \
28-
'nvidia-cuda-runtime-cu12==12.9.*' \
29-
'libcuopt-cu12==25.10.*'
25+
pip install --extra-index-url=https://pypi.nvidia.com 'libcuopt-cu12==25.10.*'
3026
3127
3228
.. note::
@@ -36,12 +32,10 @@ This wheel is a Python wrapper around the C++ library and eases installation and
3632
3733
# CUDA 13
3834
pip install --pre --extra-index-url=https://pypi.nvidia.com --extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
39-
'nvidia-cuda-runtime==13.0.*' \
4035
'libcuopt-cu13==25.10.*'
4136
4237
# CUDA 12
4338
pip install --pre --extra-index-url=https://pypi.nvidia.com --extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
44-
'nvidia-cuda-runtime-cu12==12.9.*' \
4539
'libcuopt-cu12==25.10.*'
4640
4741
Conda

docs/cuopt/source/cuopt-python/quick-start.rst

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -13,14 +13,10 @@ pip
1313
.. code-block:: bash
1414
1515
# CUDA 13
16-
pip install --extra-index-url=https://pypi.nvidia.com \
17-
'nvidia-cuda-runtime==13.0.*' \
18-
'cuopt-cu13==25.10.*'
16+
pip install --extra-index-url=https://pypi.nvidia.com 'cuopt-cu13==25.10.*'
1917
2018
# CUDA 12
21-
pip install --extra-index-url=https://pypi.nvidia.com \
22-
'nvidia-cuda-runtime-cu12==12.9.*' \
23-
'cuopt-cu12==25.10.*'
19+
pip install --extra-index-url=https://pypi.nvidia.com 'cuopt-cu12==25.10.*'
2420
2521
2622
.. note::
@@ -30,12 +26,10 @@ pip
3026
3127
# CUDA 13
3228
pip install --pre --extra-index-url=https://pypi.nvidia.com --extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
33-
'nvidia-cuda-runtime==13.0.*' \
3429
'cuopt-cu13==25.10.*'
3530
3631
# CUDA 12
3732
pip install --pre --extra-index-url=https://pypi.nvidia.com --extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
38-
'nvidia-cuda-runtime-cu12==12.9.*' \
3933
'cuopt-cu12==25.10.*'
4034
4135
@@ -63,19 +57,19 @@ NVIDIA cuOpt is also available as a container from Docker Hub:
6357

6458
.. code-block:: bash
6559
66-
docker pull nvidia/cuopt:latest-cuda12.9-py3.12
60+
docker pull nvidia/cuopt:latest-cuda12.9-py3.13
6761
6862
.. note::
69-
The ``latest`` tag is the latest stable release of cuOpt. If you want to use a specific version, you can use the ``<version>-cuda12.9-py3.12`` tag. For example, to use cuOpt 25.5.0, you can use the ``25.5.0-cuda12.9-py3.12`` tag. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt>`_ for the list of available tags.
63+
The ``latest`` tag is the latest stable release of cuOpt. If you want to use a specific version, you can use the ``<version>-cuda12.9-py3.13`` tag. For example, to use cuOpt 25.10.0, you can use the ``25.10.0-cuda12.9-py3.13`` tag. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt/tags>`_ for the list of available tags.
7064

7165
.. note::
72-
The nightly version of cuOpt is available as ``[VERSION]a-cuda12.9-py3.12`` tag. For example, to use cuOpt 25.8.0a, you can use the ``25.8.0a-cuda12.9-py3.12`` tag.
66+
The nightly version of cuOpt is available as ``[VERSION]a-cuda12.9-py3.13`` tag. For example, to use cuOpt 25.10.0a, you can use the ``25.10.0a-cuda12.9-py3.13`` tag. Also the cuda version and python version might change in the future. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt/tags>`_ for the list of available tags.
7367

7468
The container includes both the Python API and self-hosted server components. To run the container:
7569

7670
.. code-block:: bash
7771
78-
docker run --gpus all -it --rm nvidia/cuopt:latest-cuda12.9-py3.12 /bin/bash
72+
docker run --gpus all -it --rm nvidia/cuopt:latest-cuda12.9-py3.13 /bin/bash
7973
8074
This will start an interactive session with cuOpt pre-installed and ready to use.
8175

docs/cuopt/source/cuopt-server/quick-start.rst

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,11 @@ pip
2929
3030
# CUDA 13
3131
pip install --pre --extra-index-url=https://pypi.nvidia.com --extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
32-
'nvidia-cuda-runtime==13.0.*' \
3332
'cuopt-server-cu13==25.10.*' \
3433
'cuopt-sh-client==25.10.*'
3534
3635
# CUDA 12
3736
pip install --pre --extra-index-url=https://pypi.nvidia.com --extra-index-url=https://pypi.anaconda.org/rapidsai-wheels-nightly/simple/ \
38-
'nvidia-cuda-runtime-cu12==12.9.*' \
3937
'cuopt-server-cu12==25.10.*' \
4038
'cuopt-sh-client==25.10.*'
4139
@@ -59,19 +57,19 @@ NVIDIA cuOpt is also available as a container from Docker Hub:
5957

6058
.. code-block:: bash
6159
62-
docker pull nvidia/cuopt:latest-cuda12.9-py3.12
60+
docker pull nvidia/cuopt:latest-cuda12.9-py3.13
6361
6462
.. note::
65-
The ``latest`` tag is the latest stable release of cuOpt. If you want to use a specific version, you can use the ``<version>-cuda12.9-py3.12`` tag. For example, to use cuOpt 25.5.0, you can use the ``25.5.0-cuda12.9-py3.12`` tag. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt>`_ for the list of available tags.
63+
The ``latest`` tag is the latest stable release of cuOpt. If you want to use a specific version, you can use the ``<version>-cuda12.9-py3.13`` tag. For example, to use cuOpt 25.10.0, you can use the ``25.10.0-cuda12.9-py3.13`` tag. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt/tags>`_ for the list of available tags.
6664

6765
The container includes both the Python API and self-hosted server components. To run the container:
6866

6967
.. code-block:: bash
7068
71-
docker run --gpus all -it --rm -p 8000:8000 -e CUOPT_SERVER_PORT=8000 nvidia/cuopt:latest-cuda12.9-py3.12
69+
docker run --gpus all -it --rm -p 8000:8000 -e CUOPT_SERVER_PORT=8000 nvidia/cuopt:latest-cuda12.9-py3.13
7270
7371
.. note::
74-
The nightly version of cuOpt is available as ``[VERSION]a-cuda12.9-py3.12`` tag. For example, to use cuOpt 25.8.0a, you can use the ``25.8.0a-cuda12.9-py3.12`` tag.
72+
The nightly version of cuOpt is available as ``[VERSION]a-cuda12.9-py3.13`` tag. For example, to use cuOpt 25.10.0a, you can use the ``25.10.0a-cuda12.9-py3.13`` tag. Also the cuda version and python version might change in the future. Please refer to `cuOpt dockerhub page <https://hub.docker.com/r/nvidia/cuopt/tags>`_ for the list of available tags.
7573

7674
.. note::
7775
Make sure you have the NVIDIA Container Toolkit installed on your system to enable GPU support in containers. See the `installation guide <https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html>`_ for details.

python/libcuopt/pyproject.toml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@ dependencies = [
4646
"cuopt-mps-parser==25.10.*,>=0.0.0a0",
4747
"librmm==25.10.*,>=0.0.0a0",
4848
"nvidia-cublas",
49+
"nvidia-cudart",
4950
"nvidia-curand",
5051
"nvidia-cusolver",
5152
"nvidia-cusparse",

0 commit comments

Comments
 (0)