Registry / data / libcudf-cu12

libcudf-cu12

JSON →
library26.6.0pypypiunverified

`libcudf-cu12` is the underlying C++ library for cuDF, a GPU-accelerated DataFrame library for Python, part of the NVIDIA RAPIDS ecosystem. It enables pandas-like data manipulation directly on the GPU, leveraging CUDA for high performance. This PyPI meta-package primarily serves as a runtime dependency that transitively pulls in the Python `cudf-cu12` package. cuDF follows a rapid monthly release cadence (YYYY.MM.patch), consistently introducing new features and breaking changes. The current stable version is `26.4.0`.

pip install libcudf-cu12
INSTALL
IMPORT
SIG · LIBCUDF-CU12
L
libcudf-cu12
datapythonv26.6.0
Install
16.8s avg
Import
Disk
491MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.0.0a0.dev0 · 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.103.920 runs
installs and imports cleanly · install 0.0s · import 0.000s · 17.8MB
glibc
py 3.103.920 runs
installs and imports cleanly · install 16.8s · import 0.000s · 1126.4MB
491MB installed
● package 491MB
Code
Verified usage

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

cudf
import cudf
import libcudf
`libcudf-cu12` is a meta-package that installs `cudf-cu12`, which provides the `cudf` module for Python usage. Do not attempt to import `libcudf` directly.
DataFrame
import cudf gdf = cudf.DataFrame(...)

This quickstart demonstrates how to create a basic cuDF DataFrame and perform a simple aggregation, showcasing its pandas-like API for GPU data manipulation.

import cudf import numpy as np # Create a cuDF DataFrame directly on the GPU data = { 'col1': np.random.rand(10), 'col2': np.random.randint(0, 100, 10) } gdf = cudf.DataFrame(data) print("cuDF DataFrame head:") print(gdf.head()) print(f"\nMean of col1: {gdf['col1'].mean().item()}")
Debug
Known issues
breakingcuDF introduces frequent breaking changes with its monthly release cycle, affecting API signatures (e.g., `DataFrame.apply_chunks` removal), internal behaviors, and default arguments. Examples include changes to partitioning APIs and removal of resource management functions.
fix
Thoroughly review release notes on the GitHub repository (`github.com/rapidsai/cudf/releases`) for specific version updates and migration guides. Pin exact versions of `cudf-cuXX` and its core dependencies (`cupy-cudaXX`, `pyarrow`) to ensure stability.
affects: All major versions (e.g., v25.10.00, v25.12.00, v26.02.00, v26.04.00).
gotchaStrict compatibility requirements exist for `pyarrow`, `cupy-cudaXX`, and the underlying CUDA Toolkit. Mismatched versions are a common source of runtime errors, unexpected behavior, and performance issues, especially after minor cuDF updates. For `v26.04.00`, `pyarrow 19` is required.
fix
Always ensure `pyarrow` and `cupy-cudaXX` versions precisely match the `cudf-cuXX` requirements specified in the `cudf` documentation, PyPI dependencies, or `conda` environment. Use `pip show cudf-cu12` to inspect required distributions.
affects: All versions.
deprecatedSeveral APIs, including specific `nvtext` functions (`byte_pair_encoding`), `DataFrame.apply_rows`, `DataFrame.apply_chunks`, and certain `cudf::round` overloads for float types, have been deprecated or removed in recent versions.
fix
Migrate your code to use the recommended alternative APIs as documented in the official cuDF documentation or detailed in the respective release notes. Avoid using experimental or preview features in production without careful testing.
affects: v25.08.00, v25.10.00, v26.04.00 and later.
Upgrade
Version history
26.6.0latest on PyPI · released Jun 9, 2026
Audit
Dependencies
cudf-cu12requiredThis meta-package primarily installs cudf-cu12, which provides the Python API.
pyarrowrequiredCritical for data interchange; strict version compatibility with cuDF is required.
cupy-cuda12xrequiredEssential for underlying GPU array operations, must match CUDA version.
Agent activity
1 hits · last 30 days
Meta
1
Resources
libcudf-cu12 — pip install libcudf-cu12 · libregistry