# NVIDIA/cuda-quantum

C++ and Python support for the CUDA Quantum programming model for heterogeneous quantum-classical workflows

Repository: https://github.com/NVIDIA/cuda-quantum
Canonical: https://ross.abutalabs.com/products/cuda-quantum
Homepage: https://nvidia.github.io/cuda-quantum/
Language: C++
License: Apache-2.0
License Family: permissive
Topics: cpp, python, quantum, quantum-algorithms, quantum-computing, quantum-machine-learning, quantum-programming-language, unitaryhack, hacktoberfest
Last push: 2026-09-02T23:53:49+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 79, longevity 90
- inputs: {"age_days": 1268, "days_push": 0, "days_rel": 62, "gap_med": 70.0, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1124, forks 447 (observed 2026-09-03T02:15:06.797191+00:00)

## What it is
NVIDIA's CUDA-Q platform providing C++ and Python tools for programming heterogeneous quantum-classical workflows across QPUs, GPUs, and CPUs. It includes the nvq++ compiler, a runtime, and integrated CPU/GPU simulator backends.

## Use cases
- write quantum programs in C++ or Python
- simulate quantum circuits on GPUs
- build hybrid quantum-classical algorithms
- run quantum machine learning workflows
- compile quantum kernels for real QPUs
- prototype quantum algorithms with CPU simulators

## When to choose
- you need GPU-accelerated quantum circuit simulation
- you want a single framework mixing quantum and classical HPC code
- you target NVIDIA hardware or multiple QPU backends
- you want C++ performance with Python bindings

## When to avoid
- you only need simple educational quantum circuit demos
- you work outside the NVIDIA/CUDA ecosystem with no GPU access
- you need a pure quantum-only framework without classical integration

## Facets
- artifact type: framework
- maturity: active
- function: programming-language, compiler, simulation, sdk
- domain: quantum-computing, gpu-computing, machine-learning, developer-tools
- platform: cpp, python
- tags: quantum-computing, hybrid-quantum-classical, qpu, cuda, quantum-machine-learning, compiler-infrastructure, linux, gpu

## Member repositories
- NVIDIA/cuda-quantum (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:06.797191+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:41:03.927765+00:00, confidence not recorded.
  - readme: https://github.com/NVIDIA/cuda-quantum (fetched 2026-09-03T02:15:06.797191+00:00, sha 3f8b1986531e)
  - homepage: https://nvidia.github.io/cuda-quantum/ (fetched 2026-08-29T12:44:44.881844+00:00, sha 44136fa355b3)
- Data as of 2026-08-30T08:39:29.467469+00:00.
