Skip to navigation

Rust Installation

View as Markdown

Use this page when you need the NVIDIA cuVS Rust bindings. The Rust crate depends on the native NVIDIA cuVS C API, so libcuvs.so and libcuvs_c.so must be available when compiling and running Rust code.

All NVIDIA cuVS routine implementations live in the C++ core. The Rust bindings call into the native C and C++ libraries, so install both libcuvs_c and libcuvs.

Install Pre-Compiled Dependencies

Install the native libraries first:

# CUDA 13
conda install -c rapidsai -c conda-forge libcuvs cuda-version=13.3
# CUDA 12
conda install -c rapidsai -c conda-forge libcuvs cuda-version=12.9

The Rust bindings require Rust 1.85 or newer. Regenerating the bindings with bindgen also requires libclang.

When building examples or working on the Rust bindings from source, use the centralized build environment guidance. A Rust-specific environment YAML file is also available in conda/environments when you want a narrower development environment.

Configure LIBCLANG_PATH so Rust bindgen can find libclang:

LIBCLANG_PATH=$(dirname "$(find "$CONDA_PREFIX" -name libclang.so | head -n 1)")
export LIBCLANG_PATH

Add NVIDIA cuVS to your Rust project:

[dependencies]
cuvs = ">=24.6.0"

Then build or run your project with Cargo:

cargo build

Build From Source

Before building from source, review the shared C++ source-build prerequisites, including the recommended conda environment setup for build dependencies.

Build the native libraries first if needed:

./build.sh libcuvs

Then build the Rust bindings:

./build.sh rust