opencv-contrib-python
Wrapper package for OpenCV python bindings.
What it is and what it does
opencv-contrib-python is a Python wrapper around OpenCV's full feature set, including both core and contrib modules. It bundles pre-compiled OpenCV binaries as wheels, eliminating the need to build OpenCV separately. The package depends only on numpy and provides CPU-only processing. It supports Python 3.6 through 3.14 across Windows, macOS, and Linux.
Developers use it for image and video processing, feature detection, object recognition, and machine learning on visual data. The contrib modules add specialized algorithms beyond the core library. Installation is straightforward via pip on supported platforms, though Windows users may need to install Visual C++ redistributables. The package is actively maintained with recent releases.
Use it for:
- Image and video processing pipelines for frame extraction, filtering, and transformation
- Feature detection and matching for image alignment and panorama creation
- Object detection and tracking in images and video streams
- Image enhancement, filtering, and morphological operations for preprocessing
- Classical computer vision tasks using pre-built algorithm implementations
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
opencv-contrib-python provides Python bindings to OpenCV's full library, including contrib modules for advanced computer vision tasks like feature detection, image processing, and machine learning on images.
Yes. opencv-contrib-python is actively maintained, widely used (top 5000 PyPI packages), has no known vulnerabilities, and offers permissive Apache 2.0 licensing. Install friction is moderate but manageable via pre-built wheels. Choose this over the base package only if you specifically need contrib modules; otherwise the smaller base package may suffice. Verify your platform has required system libraries before installing.
Install
opencv-contrib-python on PyPI
pip
pip install opencv-contrib-pythonuv
uv add opencv-contrib-pythonpoetry
poetry add opencv-contrib-pythonInstalling opencv-contrib-python
Before you install
Pre-built wheels available for multiple platforms (macOS, Windows, Linux) with abi3 tags supporting Python 3.6+. Medium install friction due to compiled C++ bindings; Windows users may need Visual C++ redistributables. Active maintenance with release 43 days ago.
License in practice
Apache 2.0 permissive license allows commercial and private use with minimal restrictions. You may use, modify, and distribute the package freely provided you include a copy of the license.
Quickstart
pip install opencv-contrib-python
import opencv_contrib_python
# Requires numpy as runtime dependency
Windows users may need Visual C++ redistributable 2015 installed. Requires pip >= 19.3 to install manylinux2014 wheels. Do not install multiple opencv packages in the same environment.
Verify before relying
- What specific contrib modules are included and their use cases beyond core functionality
- Performance characteristics and whether contrib modules justify the larger package size
- Compatibility details on ARM-based systems beyond wheel availability
Package facts
| License | Apache 2.0 (permissive) |
| Python support | supports the current Python release (>=3.6) |
| Install friction | medium — platform-specific wheel |
| Runtime dependencies | 1 — numpy |
| Maintenance | actively maintained — 43 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 9,312,352/month — #1,548 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: opencv_contrib_python-5.0.0.93-cp37-abi3-macosx_13_0_arm64.whl; opencv_contrib_python-5.0.0.93-cp37-abi3-macosx_14_0_x86_64.whl; opencv_contrib_python-5.0.0.93-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; opencv_contrib_python-5.0.0.93-cp37-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; opencv_contrib_python-5.0.0.93-cp37-abi3-manylinux_2_28_aarch64.whl; opencv_contrib_python-5.0.0.93-cp37-abi3-manylinux_2_28_x86_64.whl; opencv_contrib_python-5.0.0.93-cp37-abi3-win32.whl; opencv_contrib_python-5.0.0.93-cp37-abi3-win_amd64.whl
Tags
More Software Development packages
Provides backported and experimental type hints…
permissive · top 100 on PyPI
numpyNumPy provides an N-dimensional array object…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
annotated-docProvides a way to document function parameters,…
permissive · top 100 on PyPI
typerTyper builds command-line applications from…
permissive · top 1,000 on PyPI
distlibDistlib provides low-level packaging utilities…
permissive · top 1,000 on PyPI
opencv-python-headlessOpenCV Python bindings for computer vision…
permissive · top 1,000 on PyPI
opencv-contrib-python-headlessProvides OpenCV's computer vision algorithms…
permissive · top 5,000 on PyPI
imutilsimutils provides convenience wrappers around…
unclear · top 15,000 on PyPI
dlibdlib is a C++ machine learning and computer…
unclear · top 15,000 on PyPI
python-mpvPython ctypes-based interface to the mpv media…
copyleft · top 15,000 on PyPI
boost-histogramboost-histogram provides Python bindings to…
permissive · top 5,000 on PyPI
pillow-heifpillow-heif adds HEIF/HEIC image format support…
copyleft · top 5,000 on PyPI
albucoreAlbucore provides optimized atomic image…
permissive · top 5,000 on PyPI
WillowWillow provides a unified API for image…
permissive · top 5,000 on PyPI