NVIDIA CURAND CUDA 12 Runtime Libraries

10.3.10.19 · active · verified Sat Mar 28

The `nvidia-curand-cu12` package provides the native runtime libraries for NVIDIA's CUDA Random Number Generation (CURAND) library, specifically compiled for CUDA Toolkit 12.x. It acts as a foundational dependency for higher-level Python libraries that wrap CUDA functionalities, enabling GPU-accelerated random number generation. The current version is 10.3.10.19, and it typically follows the CUDA Toolkit's release cadence.

Warnings

gotcha This package is a native runtime library for CUDA and does not provide a direct Python API for `curand` functions. You typically use it as a dependency for other Python libraries like CuPy or Numba that wrap CUDA functionalities.
Fix: Install a higher-level wrapper library (e.g., `cupy-cuda12x`) to interact with CURAND from Python.
breaking Requires a compatible NVIDIA CUDA-capable GPU and an NVIDIA GPU driver. Without these, the package will install but its core functionality will not be usable, potentially leading to runtime errors in dependent libraries.
Fix: Ensure your system has a supported NVIDIA GPU and the appropriate NVIDIA GPU drivers are installed and up-to-date. Verify CUDA Toolkit is correctly configured.
gotcha Dependency resolution with `pip` can be complex due to the intricate CUDA ecosystem. Installing multiple `nvidia-*cu12` packages or conflicting versions of CUDA-dependent libraries can lead to `pip` backtracking issues, resulting in slow or failed installations.
Fix: Use stricter version constraints for `nvidia-*cu12` packages and their dependants, or consider using environment managers like Conda which can sometimes handle these dependencies more robustly.
gotcha The `cu12` suffix indicates compatibility with CUDA Toolkit 12.x. Using this package with applications built for different major CUDA versions (e.g., CUDA 11.x) will likely lead to compatibility issues or runtime failures.
Fix: Ensure all CUDA-dependent libraries and the installed CUDA Toolkit version match the `cu12` designation of this package.

Install

pip install nvidia-curand-cu12 Install via pip

Imports

No direct Python imports
```
This package primarily provides native runtime libraries and is typically consumed by other Python wrappers (e.g., CuPy, Numba) rather than being directly imported in Python code.
```
`nvidia-curand-cu12` is a low-level runtime dependency; its functionalities are exposed through higher-level libraries that interface with the CUDA Toolkit.

Quickstart

This quickstart demonstrates how a higher-level library like CuPy would utilize the underlying CURAND runtime provided by `nvidia-curand-cu12`. The `nvidia-curand-cu12` package itself does not expose direct Python APIs for import, but rather provides the necessary native libraries for GPU-accelerated random number generation that CuPy (or similar libraries) wrap. Ensure CuPy is installed (`pip install cupy-cuda12x`) and a CUDA-capable GPU is present.

# The nvidia-curand-cu12 package itself is not directly imported.
# Instead, its functionalities are used by other libraries.
# Here's an example using CuPy, which would leverage CURAND under the hood.
import cupy as cp

# Ensure a CUDA-capable GPU is available
if cp.cuda.is_available():
    print(f"CUDA is available. Current device: {cp.cuda.Device().name}")

    # Generate random numbers using CuPy, which utilizes CURAND
    # on the GPU if nvidia-curand-cu12 is correctly installed and configured.
    gpu_random_array = cp.random.rand(5)
    print("GPU-generated random array:", gpu_random_array)

    # Example of generating normally distributed random numbers
    gpu_normal_array = cp.random.normal(loc=0.0, scale=1.0, size=5)
    print("GPU-generated normal array:", gpu_normal_array)

else:
    print("CUDA is not available. Please ensure a compatible GPU and CUDA Toolkit are installed.")

view raw JSON →