oneccl

library2022.0.0pypypiunverified

Intel oneAPI Collective Communications Library (oneCCL) provides an efficient implementation of communication patterns used in deep learning. Version 2022.0.0 is distributed as a runtime environment package for Python, typically used with Intel optimizations for distributed training. Release cadence is tied to Intel oneAPI annual releases.

ai-ml

pip install oneccl

package ↗homepage ↗

INSTALL

IMPORT

SIG · ONECCL

oneccl

ai-mlpythonv2022.0.0

Install

13.4s avg

Import

—

Disk

16MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2022.0.0 · 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.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 13.4s · import 0.000s · 19MB

16MB installed

● package 16MB

Code

Verified usage

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

ccl

✓ import oneccl_bindings as ccl

✗ import oneccl_bindings as ccl

Initializes a PyTorch distributed process group using the CCL backend (oneCCL). Requires environment variables RANK, WORLD_SIZE, MASTER_ADDR, MASTER_PORT to be set.

import torch.distributed as dist import oneccl_bindings as ccl import os # Initialize process group with oneCCL backend dist.init_process_group( backend='ccl', init_method='env://', rank=int(os.environ.get('RANK', 0)), world_size=int(os.environ.get('WORLD_SIZE', 1)) ) if dist.get_rank() == 0: print("oneCCL initialized successfully")

Debug

Known issues

gotchaThe pip package 'oneccl' is a runtime environment (no Python code). You must install 'oneccl_bindings' separately or use the Intel conda channel to get the actual bindings.

fix

Install oneccl_bindings via conda: conda install -c intel oneccl_bindings_pt (for PyTorch) or use the full Intel AI Kit.

affects: all

breakingoneCCL 2022.0.0 changed backend initialization: the backend name was renamed from 'ccl' to 'ccl' (still 'ccl') but the package structure changed. Old imports from 'oneccl_bindings_for_pytorch' no longer exist.

fix

Use 'import oneccl_bindings' and set backend='ccl' in torch.distributed.init_process_group.

affects: >=2022.0.0

deprecatedThe older 'oneccl_bindings_for_pytorch' package is deprecated; use the unified 'oneccl_bindings'.

fix

Replace 'import oneccl_bindings_for_pytorch' with 'import oneccl_bindings'.

affects: >=2021.3

gotchaoneCCL is only supported on Linux and requires MPI or a compatible runtime (e.g., Intel MPI). Windows users may encounter DLL errors.

fix

Use Linux (preferably with Intel MPI installed). For Windows, consider WSL2.

affects: all

Upgrade

Version history

2022.0.0latest on PyPI · released Apr 24, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/oneccl/ ↗

homepagehttps://software.intel.com/en-us/articles/empowering-science-with-high-performance-python ↗