wheelgap tracker

opencv-python-headless wheel coverage

pip install opencv-python-headless on Python 3.14: wheels for the whole tree on 4 of the 6 platforms checked; builds from source on 2 platforms.

From the wheelgap 0.9.0 scan of 2026-11-16.

opencv-python-headless 5.0.0.93

#449 by downloads · PyPI

Campaigns: On the to-do list of musllinux aarch64 wheels for the top 500 · On the to-do list of Windows on ARM wheels for the top 500.

Platform3.133.143.14t3.153.15t
Linux x86_64wheelwheelfrom sourcefails to build: compile errorwheelfrom source
Linux ARM64wheelwheelfrom sourcewheelfrom source
Alpine x86_64from sourcefrom sourcefrom sourcefrom sourcefrom source
Alpine ARM64from sourcefrom sourcefails to build: needs a system libraryfrom sourcefrom sourcefrom source
macOS Apple siliconwheelwheelfrom sourcewheelfrom source
macOS Intelwheelwheelfrom sourcewheelfrom source
Windows x86_64wheelwheelfrom sourcewheelfrom source
Windows ARM64from sourcefrom sourcefails to build: compile errorfrom sourcefails to build: compile errorfrom sourcefrom source
Pyodide (browser)can't installcan't installn/an/an/a

Why? uvx wheelgap opencv-python-headless==5.0.0.93 -p 3.15 -t all --explain

Install coverage with dependencies

Wheelgap checks the scanned release and its dependencies without extras. A target is marked “Not checked” if wheelgap could not resolve the full dependency tree or verify its packages.

TargetInstall result
3.14 linux-x86_64Wheels for the whole tree
3.14 linux-aarch64Wheels for the whole tree
3.14 musl-aarch64Builds from source
  • opencv-python-headless==5.0.0.93 builds from source
3.14 macos-arm64Wheels for the whole tree
3.14 macos-x86_64Wheels for the whole tree
3.14 win-arm64Builds from source
  • opencv-python-headless==5.0.0.93 builds from source
3.14t linux-x86_64Builds from source
  • opencv-python-headless==5.0.0.93 builds from source
3.14t win-arm64Builds from source
  • opencv-python-headless==5.0.0.93 builds from source

Build lab

A dated observation on GitHub's runners, not a promise about your machine: runners come with compilers and many system libraries preinstalled, so a build that works there can still need setup on your machine.

TargetFrom sourceDetails
3.14 musl-aarch64fails fails to build: needs a system libraryubuntu-24.04-arm, Python 3.14.10, 2026-11-15 · run
logAn error occurred while building with CMake. | note: This error originates from a subprocess, and is likely not a problem with pip. | ERROR: Failed building wheel for opencv-python-headless | ERROR: Failed to build one or more wheels
3.14 win-arm64fails fails to build: compile errorwindows-11-arm, Python 3.14.10, 2026-11-15 · run
logAn error occurred while building with CMake. | note: This error originates from a subprocess, and is likely not a problem with pip. | ERROR: Failed building wheel for opencv-python-headless | ERROR: Failed to build one or more wheels
3.14t linux-x86_64fails fails to build: compile errorubuntu-24.04, Python 3.14.10t, 2026-11-15 · run
logAn error occurred while building with CMake. | note: This error originates from a subprocess, and is likely not a problem with pip. | ERROR: Failed building wheel for opencv-python-headless | ERROR: Failed to build one or more wheels
3.14t win-arm64fails fails to build: compile errorwindows-11-arm, Python 3.14.10t, 2026-11-15 · run
logAn error occurred while building with CMake. | note: This error originates from a subprocess, and is likely not a problem with pip. | ERROR: Failed building wheel for opencv-python-headless | ERROR: Failed to build one or more wheels

Notes

opencv-python-headless has manylinux wheels but no musllinux ones, so on Alpine and other musl distributions pip builds OpenCV from the sdist, as its README describes. musllinux wheels are requested in opencv/opencv-python#1099; on a glibc-based distribution such as Debian, pip installs the manylinux wheel instead (not on free-threaded Python).

Upstream issue · Alpine x86_64, Alpine ARM64 · checked 2026-11-12

github.com/opencv/opencv-python/issues/1099 · github.com/opencv/opencv-python#source-distributions · pypi.org/project/opencv-python-headless/#files

Know a workaround, an alternative package, a conda-forge build or an upstream issue for opencv-python-headless? Add a note (a pull request on GitHub; the format is in notes/README.md).

Badge for your README

[![wheels](https://img.shields.io/endpoint?url=https://wheelgap.github.io/tracker/badge/opencv-python-headless.json)](https://wheelgap.github.io/tracker/#package=opencv-python-headless)
[![wheels with dependencies](https://img.shields.io/endpoint?url=https://wheelgap.github.io/tracker/badge/opencv-python-headless-tree.json)](https://wheelgap.github.io/tracker/p/opencv-python-headless/)

Package JSON

All 5,000 packages