Intel Plugin for TorchCodec
Overview
TorchCodec is a high-performance Python library designed for media processing (decoding and encoding) using PyTorch* tensors. Intel® XPU plugin for TorchCodec enables hardware acceleration for video operations on Linux. Both TorchCodec and Intel® plugin rely on the FFmpeg libraries for their operations which must be pre-installed on the system. Intel® plugin further assumes that FFmpeg is built with the VAAPI support.
TorchCodec will automatically load Intel® XPU plugin if it is installed on the system via Python packages entry point mechanism. After importing TorchCodec, pass XPU device to initialize TorchCodec decoder or encoder:
import torchcodec
decoder = torchcodec.decoders.VideoDecoder(
"input.mp4", device="xpu:0")
Supported hardware
All the Intel GPU hardware enabled for XPU PyTorch backend with hardware media decoding capabilities is supported.
Supported FFmpeg versions
Intel Plugin for TorchCodec is being validated with FFmpeg versions range [6, 9].
Installation
Pre-built release wheels are available at PyPI. Installation requires PyTorch with enabled XPU support which can be fetched from https://download.pytorch.org/whl/xpu:
pip install torchcodec-xpu \
--extra-index-url https://download.pytorch.org/whl/xpu
FFmpeg with enabled VAAPI backend must be installed on the system separately. Pre-built wheels support FFmpeg versions range [6, 9].
Environment variables
The following environment variables can be used to customize the behavior of Intel Plugin for TorchCodec:
-
TORCHCODEC_XPU_LOG_LEVEL=0|1|2|3|4(default:0) - log level. -
USE_SYCL_KERNELS = on|off(default:off) - use SYCL kernels for augmentation such as color space conversion instead of VAAPI interface. If SYCL kernels are requested but can not be used due to hardware limitations, then fallback to VAAPI will be attempted. -
CPU_FALLBACK=on|off(default:on) - allow CPU fallback. -
FORCE_CPU_FALLBACK=on|off(default:off) - force CPU fallback.
Known limitations
- Intel® Data Center GPU Max Series (Ponte Vecchio, PVC) GPUs are not supported due to missing hardware media engines. Execution will fallback to CPU.
- SYCL color space conversion kernel is not supported on Intel® Arc™ Pro A-Series Graphics (Alchemist, DG2) and Intel® Data Center GPU Flex Series (Archtic Sound, ATS-M) GPUs as 64-bit floating point operations used in the kernel are not available on these GPUs. Execution will fallback to less performant color space conversion on CPU or on media engines via FFmpeg VAAPI.
Metadata
Release files for torchcodec-xpu 0.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| torchcodec_xpu-0.17.0-cp314-cp314-manylinux_2_24_x86_64.whl | CPython 3.14 | CPython 3.14 | Linux glibc 2.24+ x86-64 | Details for torchcodec_xpu-0.17.0-cp314-cp314-manylinux_2_24_x86_64.whl |
| torchcodec_xpu-0.17.0-cp313-cp313-manylinux_2_24_x86_64.whl | CPython 3.13 | CPython 3.13 | Linux glibc 2.24+ x86-64 | Details for torchcodec_xpu-0.17.0-cp313-cp313-manylinux_2_24_x86_64.whl |
| torchcodec_xpu-0.17.0-cp312-cp312-manylinux_2_24_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.24+ x86-64 | Details for torchcodec_xpu-0.17.0-cp312-cp312-manylinux_2_24_x86_64.whl |
| torchcodec_xpu-0.17.0-cp311-cp311-manylinux_2_24_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.24+ x86-64 | Details for torchcodec_xpu-0.17.0-cp311-cp311-manylinux_2_24_x86_64.whl |
| torchcodec_xpu-0.17.0-cp310-cp310-manylinux_2_24_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.24+ x86-64 | Details for torchcodec_xpu-0.17.0-cp310-cp310-manylinux_2_24_x86_64.whl |
Total release size: 2.7 MB
Release files / torchcodec_xpu-0.17.0-cp314-cp314-manylinux_2_24_x86_64.whl
| Download URL | torchcodec_xpu-0.17.0-cp314-cp314-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 538.0 kB |
| Tags | CPython 3.14 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
953a5fa29cd4e4e13e8911af19d64faa6e2e0bafcb06ef212fd4f2c9d27b6f78
|
|
BLAKE2b-256 checksum How to use checksums |
43c70cc80451d17251116ce7f5f419a880458c55a5d4166485ef055cdf0afbee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / torchcodec_xpu-0.17.0-cp313-cp313-manylinux_2_24_x86_64.whl
| Download URL | torchcodec_xpu-0.17.0-cp313-cp313-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 538.0 kB |
| Tags | CPython 3.13 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
199c581e93cc3ccc7b9056ef75d10fd151d12b54295fe35d7520fafcbf4300d5
|
|
BLAKE2b-256 checksum How to use checksums |
0ba48343663e0d1f76bb0dac77f2a2123bbfa033bd36f72417cba35f4e5ca351
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / torchcodec_xpu-0.17.0-cp312-cp312-manylinux_2_24_x86_64.whl
| Download URL | torchcodec_xpu-0.17.0-cp312-cp312-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 538.0 kB |
| Tags | CPython 3.12 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
9f5a0d482b783be45b8cd3cb762bd1b1653964c885c65794259159288272adcb
|
|
BLAKE2b-256 checksum How to use checksums |
1007df75fdf94fe9204743f4f38fbf16b8445a7022ec401507b5bda47a8899b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / torchcodec_xpu-0.17.0-cp311-cp311-manylinux_2_24_x86_64.whl
| Download URL | torchcodec_xpu-0.17.0-cp311-cp311-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 538.0 kB |
| Tags | CPython 3.11 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
4315ac89421bf6577f1c8b5ede03a59cf108dbb2a4c58b36dcf0ca9df91635ba
|
|
BLAKE2b-256 checksum How to use checksums |
1c76da40601ac3cc6199c64cfe32c4513ff9cf3423b7db3f600e391e4cdedc55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / torchcodec_xpu-0.17.0-cp310-cp310-manylinux_2_24_x86_64.whl
| Download URL | torchcodec_xpu-0.17.0-cp310-cp310-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 538.0 kB |
| Tags | CPython 3.10 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
156dd212abe4b1cf362856a76c59581888f219d45adc115119bebd72a89a6f14
|
|
BLAKE2b-256 checksum How to use checksums |
4ffe511192be28ba75c61838168466f51f119b6c1048b3ce9d9d112ac4987e32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logSecurity for torchcodec-xpu 0.17.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 5 files in this release have been uploaded with provenance metadata.
Attestation for torchcodec_xpu-0.17.0-cp314-cp314-manylinux_2_24_x86_64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.