NGC | Catalog
CatalogContainersCUDA Quantum

CUDA Quantum

For copy image paths and more information, please view on a desktop device.
Logo for CUDA Quantum


With a unified and open programming model, CUDA Quantum is a first-of-its-kind, open-source platform for integrated quantum-classical programming



Latest Tag



June 1, 2023

Compressed Size

2.21 GB

Multinode Support


Multi-Arch Support


0.3.0 (Latest) Scan Results

Linux / amd64


CUDA Quantum is a comprehensive framework for quantum programming. It features:

  • A programming model which extends C++ and Python with quantum kernels, enabling high-level programming in familiar languages
  • A high-performance quantum compiler, NVQ++, based on the industry standard low-level virtual machine (LLVM) toolchain
  • Interoperability with all of the leading models and tools for accelerated computing, including CUDA, ISO standard parallelism, OpenMP,
    and OpenACC
  • The ability to utilize and seamlessly switch between different quantum technologies, including state-of-the-art simulator backends
    with NVIDIA cuQuantum and a number of different physical quantum processors (QPUs)


Using the CUDA Quantum NGC Container requires the host system to have the following installed:

Docker Engine
NVIDIA Container Toolkit
For supported versions, see the container release notes. No other installation, compilation, or dependency management is required.

Running CUDA Quantum

The command to pull the container is:

docker pull

To run the container interactively:

docker run --gpus all -it --rm

The examples are located in the examples/ folder.

nvq++ examples/cpp/basics/static_kernel.cpp

If you have GPU support (e.g. you successfully provided --gpus to your docker run command), try out the 30 qubit version of this example.

nvq++ examples/cpp/basics/cuquantum_backends.cpp --qpu cuquantum

For complete getting started instructions please consult the CUDA Quantum docs

For a general guide on pulling and running containers, see Pulling a Container Image and Running a Container in the NGC Container User Guide.


The CUDA Quantum documentation is hosted along with the source code on GitHub here.

Additional Resources

The NVIDIA CUDA Quantum homepage

License Agreement

The image is governed by the following NVIDIA End User License Agreement. By downloading the NVIDIA CUDA Quantum, you accept the terms and conditions of this license. The CUDA Quantum End User License Agreement can be viewed here. Since the image includes components licensed under open-source licenses, the source code for these components can be found here.