{"library":"nvidia-cusparse-cu12","title":"NVIDIA cuSPARSE (CUDA 12)","description":"The `nvidia-cusparse-cu12` package provides the native runtime libraries for NVIDIA's cuSPARSE, a GPU-accelerated library for sparse matrix computations, specifically compatible with CUDA Toolkit 12.x. It offers highly optimized basic linear algebra subroutines for sparse matrices, enabling faster computations than CPU-only alternatives in fields like machine learning, AI, and scientific computing. This package is part of a series of NVIDIA-provided Python wheels that make CUDA runtime components available via PyPI, with the current version being 12.5.10.65. New versions are released in alignment with CUDA Toolkit updates.","language":"python","status":"active","last_verified":"Tue May 12","install":{"commands":["pip install nvidia-cusparse-cu12"],"cli":null},"imports":["import cupy.sparse # Example using a higher-level library"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\ntry:\n    import cupy as cp\n    import cupy.sparse as cps\n    import numpy as np\n\n    # Check for CUDA device\n    if cp.cuda.is_available():\n        print(f\"CUDA is available. CuPy version: {cp.__version__}\")\n        print(f\"CUDA Device Name: {cp.cuda.Device().name}\")\n\n        # Create a sparse matrix on CPU (SciPy format)\n        row = np.array([0, 1, 2, 0])\n        col = np.array([0, 1, 2, 1])\n        data = np.array([1, 2, 3, 4])\n        shape = (3, 3)\n        sparse_cpu = cps.csr_matrix((data, (row, col)), shape=shape)\n        print(\"\\nCPU Sparse Matrix:\\n\", sparse_cpu.toarray())\n\n        # Transfer to GPU and perform a sparse matrix-vector multiplication\n        sparse_gpu = cps.csr_matrix(sparse_cpu, dtype=cp.float32) # cuSPARSE generally works with float32/64\n        vector_gpu = cp.array([1.0, 2.0, 3.0], dtype=cp.float32)\n\n        result_gpu = sparse_gpu @ vector_gpu\n        print(\"\\nGPU Sparse Matrix-Vector Product (using cuSPARSE via CuPy):\\n\", result_gpu)\n\n    else:\n        print(\"CUDA is not available. Please ensure a compatible NVIDIA GPU and driver are installed.\")\n        print(\"You may need to install cupy-cuda12x manually if using a specific CUDA version.\")\n\nexcept ImportError:\n    print(\"CuPy is not installed. To run this example, install CuPy compatible with CUDA 12:\")\n    print(\"pip install cupy-cuda12x\")\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")","lang":"python","description":"This quickstart demonstrates how a higher-level Python library like CuPy leverages `nvidia-cusparse-cu12` for GPU-accelerated sparse matrix operations. The `nvidia-cusparse-cu12` package itself does not expose direct Python APIs. This code checks for CUDA availability and performs a basic sparse matrix-vector multiplication using CuPy's sparse module.","tag":"stale","tag_description":"widespread failures or data too old to trust","last_tested":"2026-04-24","results":[{"runtime":"python:3.10-alpine","exit_code":1},{"runtime":"python:3.10-slim","exit_code":-1},{"runtime":"python:3.11-alpine","exit_code":1},{"runtime":"python:3.11-slim","exit_code":-1},{"runtime":"python:3.12-alpine","exit_code":1},{"runtime":"python:3.12-slim","exit_code":-1},{"runtime":"python:3.13-alpine","exit_code":1},{"runtime":"python:3.13-slim","exit_code":-1},{"runtime":"python:3.9-alpine","exit_code":1},{"runtime":"python:3.9-slim","exit_code":-1}]},"compatibility":{"tag":"stale","tag_description":"widespread failures or data too old to trust","last_tested":"2026-05-12","installed_version":null,"pypi_latest":"12.5.10.65","is_stale":null,"summary":{"python_range":"3.10–3.9","success_rate":25,"avg_install_s":9.9,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":10.5,"import_time_s":null,"mem_mb":null,"disk_size":"574M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":9.8,"import_time_s":null,"mem_mb":null,"disk_size":"576M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":9.4,"import_time_s":null,"mem_mb":null,"disk_size":"568M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":9,"import_time_s":null,"mem_mb":null,"disk_size":"568M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":null,"install_time_s":10.8,"import_time_s":null,"mem_mb":null,"disk_size":"574M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"nvidia-cusparse-cu12","exit_code":1,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null}]}}