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.
| Platform | 3.13 | 3.14 | 3.14t | 3.15 | 3.15t |
|---|---|---|---|---|---|
| Linux x86_64 | wheel | wheel | from sourcefails to build: compile error | wheel | from source |
| Linux ARM64 | wheel | wheel | from source | wheel | from source |
| Alpine x86_64 | from source | from source | from source | from source | from source |
| Alpine ARM64 | from source | from sourcefails to build: needs a system library | from source | from source | from source |
| macOS Apple silicon | wheel | wheel | from source | wheel | from source |
| macOS Intel | wheel | wheel | from source | wheel | from source |
| Windows x86_64 | wheel | wheel | from source | wheel | from source |
| Windows ARM64 | from source | from sourcefails to build: compile error | from sourcefails to build: compile error | from source | from source |
| Pyodide (browser) | can't install | can't install | n/a | n/a | n/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.
| Target | Install result |
|---|---|
| 3.14 linux-x86_64 | Wheels for the whole tree |
| 3.14 linux-aarch64 | Wheels for the whole tree |
| 3.14 musl-aarch64 | Builds from source
|
| 3.14 macos-arm64 | Wheels for the whole tree |
| 3.14 macos-x86_64 | Wheels for the whole tree |
| 3.14 win-arm64 | Builds from source
|
| 3.14t linux-x86_64 | Builds from source
|
| 3.14t win-arm64 | 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.
| Target | From source | Details |
|---|---|---|
| 3.14 musl-aarch64 | fails fails to build: needs a system library | ubuntu-24.04-arm, Python 3.14.10, 2026-11-15 · runlogAn 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-arm64 | fails fails to build: compile error | windows-11-arm, Python 3.14.10, 2026-11-15 · runlogAn 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_64 | fails fails to build: compile error | ubuntu-24.04, Python 3.14.10t, 2026-11-15 · runlogAn 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-arm64 | fails fails to build: compile error | windows-11-arm, Python 3.14.10t, 2026-11-15 · runlogAn 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
[](https://wheelgap.github.io/tracker/#package=opencv-python-headless)[](https://wheelgap.github.io/tracker/p/opencv-python-headless/)