Install & Compatibility
Where this runs
tested against v2026.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
muslpy 3.10–3.910 runs
build_error
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 8.5s · import 0.000s · 19MB
16MB installed
● package 16MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
N/A
✓ This package provides a C++/SYCL runtime component and is not designed for direct Python import.
Python libraries like dpctl discover and link to this runtime automatically if installed and environment variables are correctly set.
This quickstart demonstrates how a Python application, using `dpctl` (a common Python interface for SYCL), can verify the presence and availability of the Intel SYCL runtime. Direct imports of `intel-sycl-rt` are not applicable, as it's a backend runtime.
import dpctl
# Check if a SYCL device is available
if dpctl.has_sycl_devices():
# Get a default SYCL device (e.g., GPU if available, otherwise CPU)
device = dpctl.select_default_device()
print(f"Selected SYCL device: {device.name}")
# The SYCL runtime is now implicitly active and available to dpctl.
# For actual computation, you would typically use libraries like dpnp or numba-dppy.
print("SYCL runtime is operational via dpctl. Ensure oneAPI environment is sourced.")
else:
print("No SYCL devices found. Ensure intel-sycl-rt is installed, oneAPI environment is sourced, and drivers are correct.")
Debug
Known issues
gotchaThe SYCL runtime often requires specific environment variables (e.g., `ONEAPI_ROOT`, `DPCPP_HOME`) to be sourced from the oneAPI `setvars.sh` script for proper discovery by Python libraries like `dpctl`.fixExecute `source /opt/intel/oneapi/setvars.sh` (or equivalent path) in your shell before running Python applications that use SYCL.
affects: All versions
breakingMixing `intel-sycl-rt` from different oneAPI toolkit versions or using it with Python libraries (e.g., `dpctl`) compiled against an incompatible oneAPI version can lead to runtime errors or device detection failures.fixEnsure all oneAPI components and dependent Python libraries are from a consistent oneAPI toolkit version. Consider using Conda environments for strict version control.
affects: All versions when mixed
gotchaFor GPU acceleration, ensure you have the correct and up-to-date Intel GPU drivers installed. Outdated or missing drivers will prevent SYCL devices from being detected and used.fixRefer to Intel's documentation for installing the latest GPU drivers for your system. Verify driver installation using `sycl-ls` or `dpctl.has_sycl_devices()`.
affects: All versions
Upgrade
Version history
2026.0.0latest on PyPI · released Apr 24, 2026
Audit
Dependencies
No dependency data recorded yet.