Versions

NCCL4Py exposes helpers to inspect the installed NCCL stack: nccl4py itself, the version of the NCCL headers its bindings were generated from, and the loaded libnccl.so.

import nccl.core

nccl.core.show_versions()      # human-readable block to stdout
v = nccl.core.get_version()    # programmatic snapshot

show_versions

nccl.core.show_versions() → None: Print nccl4py, binding, and loaded-libnccl version information.

get_version

nccl.core.get_version() → VersionInfo: Return structured nccl4py, binding, and loaded-libnccl versions.

VersionInfo

class nccl.core.VersionInfo(nccl4py: Version, nccl_bindings: Version, libnccl: LibraryInfo | None)

Bases: object

Version snapshot of nccl4py, its bindings, and loaded libnccl.

nccl4py: Version: nccl4py distribution version.

nccl_bindings: Version: NCCL header version from which the bindings were generated.

libnccl: LibraryInfo | None: Loaded libnccl information, or None when the library is unavailable.

LibraryInfo

class nccl.core.LibraryInfo(version: Version, cuda_variant: Version | None, path: Path | None)

Bases: object

Version, CUDA build variant, and loaded path for libnccl.

version: Version: Loaded libnccl release version.

cuda_variant: Version | None: CUDA toolkit major.minor used to build libnccl, when discoverable.

path: Path | None: Path of the loaded libnccl, when discoverable.