Skip to main content

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)

Table of built distributions (wheels) for torchcodec-xpu 0.17.0
File Actions
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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

Security 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.

Select from 5 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page