Intel oneAPI Collective Communications Library

2022.0.0 verified Sat May 09 auth: no python maintenance

Intel oneAPI Collective Communications Library (oneCCL) provides high-performance collective communication primitives for deep learning and HPC workloads. Version 2022.0.0 is an older release; the library has evolved and newer versions are recommended. Release cadence is annual.

pip install oneccl-devel

Common errors

error ModuleNotFoundError: No module named 'oneccl' ↓

cause Importing incorrectly as 'oneccl' instead of 'oneccl_devel'.

fix

Use import oneccl_devel.

error ImportError: cannot import name '...' from 'oneccl_devel' ↓

cause OneCCL devel only contains version info; no functions or classes.

fix

This package is not meant to provide API; use oneccl_bindings_for_pytorch or similar.

Warnings

gotcha oneccl-devel is a development package not intended for direct use; it is a dependency for building extensions like oneCCL bindings. Users should use higher-level packages like `oneccl_bindings_for_pytorch`. ↓

fix Install `oneccl_bindings_for_pytorch` instead.

gotcha The package name includes 'devel' but does not install development headers; it only provides Python stubs/version info. ↓

fix For actual functionality, install the full oneCCL runtime via Intel's distribution.

Imports

oneccl_devel
wrong
```
import oneccl
```
correct
```
import oneccl_devel
```
The correct module name is oneccl_devel, not oneccl.

Quickstart

Verify installation by printing version.

import oneccl_devel
print(oneccl_devel.__version__)