opencv-contrib-python-headless
Wrapper package for OpenCV python bindings.
Decision gist · record as of 2026-08-14
Yes, if you need OpenCV's contrib modules in a server or container environment. The headless variant is the right choice for any non-GUI deployment, reducing image size and dependency complexity. Install friction is moderate but manageable with modern pip; maintenance is active and security record is clean. Choose this over standard packages when GUI functionality is not required.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- On Windows, Visual C++ redistributable 2015 or later may be required; on older Windows versions, Universal C Runtime may also be needed.
- Requires pip >= 19.3 to install manylinux2014 wheels.
- Medium install friction due to compiled C++ bindings and platform-specific wheels, but pre-built binaries for common platforms (x86_64, aarch64, Windows, macOS) reduce build complexity.
License · maintenance · safety
Apache 2.0 (permissive) — 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 the license notice.
last release 2026-07-02 (43 days) · last repo commit 2026-07-28 · 5,349 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,998,610 downloads/mo, #2,792 on PyPI
Alternatives
Verify before relying
pip install opencv-contrib-python-headless
import opencv_contrib_python_headless
# Use with numpy for image processing tasks- Whether all contrib modules are fully functional in headless mode without GUI-dependent features
- Performance characteristics compared to building from source with CUDA or other accelerators
- Compatibility with non-standard Python implementations beyond CPython
- Specific usage patterns and API surface for contrib modules in this distribution
What it is and what it does
opencv-contrib-python-headless is a pre-built wheel distribution of OpenCV that includes both core and contrib (extra) modules, optimized for server and containerized environments where GUI functionality is not needed. It wraps OpenCV's C++ implementation with Python bindings, providing access to computer vision algorithms for image and video processing, feature detection, object recognition, and related tasks.
The package depends only on numpy and is designed to minimize container size and system dependencies by excluding GUI libraries. It supports Python 3.6 through 3.14 on Windows, macOS, and Linux, with platform-specific wheels for x86_64 and aarch64 architectures. The headless variant is recommended for any deployment that does not require display functions, or where another GUI framework is already in use.
Use it for
- Build Docker images for computer vision microservices without heavy GUI library dependencies
- Process images and video streams in cloud functions or batch jobs on servers
- Detect and recognize objects or features in automated image analysis pipelines
- Extract and match keypoints or descriptors for image stitching or 3D reconstruction workflows
- Perform real-time video frame processing in headless streaming or surveillance applications
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need OpenCV's contrib modules in a server or container environment.
The headless variant is the right choice for any non-GUI deployment, reducing image size and dependency complexity. Install friction is moderate but manageable with modern pip; maintenance is active and security record is clean. Choose this over standard packages when GUI functionality is not required.
Install
opencv-contrib-python-headless on PyPI
Before you install
Medium install friction due to compiled C++ bindings and platform-specific wheels, but pre-built binaries for common platforms (x86_64, aarch64, Windows, macOS) reduce build complexity. Active maintenance with recent releases; requires pip >= 19.3 and may need system C++ runtime libraries on Windows.
On Windows, Visual C++ redistributable 2015 or later may be required; on older Windows versions, Universal C Runtime may also be needed. Requires pip >= 19.3 to install manylinux2014 wheels.
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 the license notice.
Quickstart
pip install opencv-contrib-python-headless
import opencv_contrib_python_headless
# Use with numpy for image processing tasksVerify before relying
- Whether all contrib modules are fully functional in headless mode without GUI-dependent features
- Performance characteristics compared to building from source with CUDA or other accelerators
- Compatibility with non-standard Python implementations beyond CPython
- Specific usage patterns and API surface for contrib modules in this distribution
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 packagenumpy |
| Maintenance | Actively maintained 43 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,998,610 / month, #2,792 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: Information TechnologyIntended Audience :: Science/ResearchLicense :: OSI Approved :: Apache Software LicenseOperating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: POSIXOperating System :: UnixProgramming Language :: C++Programming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonTopic :: Scientific/EngineeringTopic :: Scientific/Engineering :: Image RecognitionTopic :: Software Development |
Evidence: opencv_contrib_python_headless-5.0.0.93-cp37-abi3-macosx_13_0_arm64.whl; opencv_contrib_python_headless-5.0.0.93-cp37-abi3-macosx_14_0_x86_64.whl; opencv_contrib_python_headless-5.0.0.93-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; opencv_contrib_python_headless-5.0.0.93-cp37-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; opencv_contrib_python_headless-5.0.0.93-cp37-abi3-manylinux_2_28_aarch64.whl; opencv_contrib_python_headless-5.0.0.93-cp37-abi3-manylinux_2_28_x86_64.whl; opencv_contrib_python_headless-5.0.0.93-cp37-abi3-win32.whl; opencv_contrib_python_headless-5.0.0.93-cp37-abi3-win_amd64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “opencv headless server”
- opencv-contrib-python-headlessProvides OpenCV's computer vision algorithms and image processing…
- opencv-python-headlessOpenCV Python bindings for computer vision tasks, packaged without…
- opencv-pythonopencv-python provides pre-built CPU-only OpenCV bindings for Python,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also opencv-python-headless · opencv-contrib-python · opencv-python · imutils · albucore · dlib · ImageHash · pillow-heif · qoi · Willow