---
id: opencv-contrib-python
version: "5.0.0.93"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# opencv-contrib-python — Wrapper package for OpenCV python bindings.

License: permissive · Maintenance: active · Downloads: 9.3M/mo

## 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 above — 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

pip install opencv-contrib-python
uv add opencv-contrib-python
poetry add opencv-contrib-python

## Installing 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_current
- Install friction: medium
- Maintenance: active
- Downloads: 9.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

computer vision python, image processing library, opencv contrib modules, feature detection and matching, video processing python, object detection framework, python bindings opencv, computer-vision, image-processing

[View on SkillFed](https://skillfed.io/packages/opencv-contrib-python) · [View on PyPI](https://pypi.org/project/opencv-contrib-python/)