Registry / ai-ml / custatevec-cu13

custatevec-cu13

library1.13.1pypypi✓ verified 81d ago

NVIDIA cuQuantum SDK component for state vector simulation on CUDA 13 hardware. Version 1.13.1 provides GPU-accelerated quantum state manipulation. Released alongside cuQuantum releases.

ai-ml

pip install custatevec-cu13

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · CUSTATEVEC-CU13

custatevec-cu13

ai-mlpythonv1.13.1

Install

2.4s avg

Import

—

Disk

48MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.0.0a0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 17.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.4s · import 0.000s · 83MB

48MB installed

● package 48MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

cuquantum

✓ import cuquantum

✗ import custatevec

Initialize a 2-qubit state vector on CUDA 13 using custatevec-cu13.

import custatevec import cupy as cp n_qubits = 2 n_amplitudes = 1 << n_qubits d_amplitudes = cp.zeros(n_amplitudes, dtype=cp.complex128) d_amplitudes[0] = 1.0 + 0.0j handle = custatevec.create() custatevec.initializeStateVector( handle, d_amplitudes.data.ptr, custatevec.StateVectorType.COMPUTE_64F, n_qubits, None ) print('State vector initialized') custatevec.destroy(handle)

Debug

Known issues

gotchaThe package name suffix -cu13 specifically requires CUDA 13.x runtime. Installing without matching CUDA version leads to ImportError or runtime errors.

fix

Verify CUDA version with 'nvcc --version' and install the correct custatevec-cuXX variant (e.g., custatevec-cu12 for CUDA 12).

affects: all

deprecatedcustatevec is superseded by cuQuantum Python's integrated API. Standalone custatevec usage may be deprecated in future cuQuantum releases.

fix

Consider using cuquantum-python-cu13 instead, which includes custatevec functionality via the cuQuantum SDK.

affects: >=1.13

gotchaThe CuPy version must match the CUDA major version. custatevec-cu13 is only compatible with cupy-cuda13x, not cupy-cuda12x.

fix

Run 'pip install cupy-cuda13x' alongside custatevec-cu13.

affects: all

Upgrade

Version history

1.13.1latest on PyPI · released Apr 13, 2026

Audit

Dependencies

cupy-cuda13xrequiredRequired for GPU array operations (CuPy for CUDA 13)

cuquantum-python-cu13optionalPython bindings for cuQuantum, often needed together

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/NVIDIA/cuQuantum ↗

packagehttps://pypi.org/project/custatevec-cu13/ ↗

homepagehttps://developer.nvidia.com/cuquantum-sdk ↗

docshttps://docs.nvidia.com/cuda/cuquantum/latest/custatevec/ ↗