opencv-python-headless
Wrapper package for OpenCV python bindings.
Decision gist · record as of 2026-08-14
Yes. opencv-python-headless is a mature, actively maintained library with no known vulnerabilities, permissive licensing, and broad platform support. Install it if you need computer vision in a server or containerized environment where GUI dependencies are unnecessary. The medium install friction is typical for compiled bindings and well-mitigated by pre-built wheels. Avoid it only if you need display functions or require non-free algorithms.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- On Windows, Visual C++ redistributable 2015 may be required.
- On older Windows versions, Universal C Runtime may also be needed.
- Windows N/KN editions require Media Feature Pack.
License · maintenance · safety
Apache 2.0 (permissive) — Apache 2.0 permissive license allows commercial and private use with minimal restrictions. Non-free algorithms like SURF are excluded from distribution due to patent constraints.
last release 2026-07-02 (43 days) · last repo commit 2026-07-28 · 5,348 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 50,117,128 downloads/mo, #576 on PyPI
Alternatives
Verify before relying
pip install opencv-python-headless
import opencv_python_headless
import numpy
# Haar cascade files available via data module
# haarcascade_frontalface_default.xml included- Specific API surface and function availability in the headless variant
- Performance characteristics compared to standard opencv-python package
- CUDA or GPU acceleration support in this headless build
- Whether all main modules are included or some excluded beyond GUI components
What it is and what it does
opencv-python-headless is a pre-built binary distribution of OpenCV's Python bindings optimized for server and containerized environments. It strips out GUI library dependencies to reduce image size and dependency chains, making it ideal for Docker, cloud deployments, and headless systems where display functions are not needed.
The package wraps OpenCV C++ functionality and exposes computer vision capabilities through Python, including image and video processing, object detection, and feature extraction. It depends only on numpy and comes with Haar cascade classifier files for common tasks. The package supports Python 3.6 through 3.14 across Windows, macOS, and Linux, with pre-built wheels available for multiple architectures.
Use it for
- Building Docker containers for video analysis or image processing microservices without GUI overhead
- Server-side object detection in web applications or APIs
- Batch image processing pipelines in cloud environments or CI/CD systems
- Machine learning training pipelines that need image preprocessing
- Real-time video stream analysis in headless environments like embedded systems
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
opencv-python-headless is a mature, actively maintained library with no known vulnerabilities, permissive licensing, and broad platform support. Install it if you need computer vision in a server or containerized environment where GUI dependencies are unnecessary. The medium install friction is typical for compiled bindings and well-mitigated by pre-built wheels. Avoid it only if you need display functions or require non-free algorithms.
Install
opencv-python-headless on PyPI
Before you install
Medium install friction due to binary wheel compilation across multiple platforms. Active maintenance with recent releases; repo shows 5348 stars and last commit on 2026-07-28. Requires pip >= 19.3 and may need Visual C++ redistributables on Windows or system libraries on Linux.
On Windows, Visual C++ redistributable 2015 may be required. On older Windows versions, Universal C Runtime may also be needed. Windows N/KN editions require Media Feature Pack. Requires pip >= 19.3 to install manylinux2014 wheels.
License in practice
Apache 2.0 permissive license allows commercial and private use with minimal restrictions. Non-free algorithms like SURF are excluded from distribution due to patent constraints.
Quickstart
pip install opencv-python-headless
import opencv_python_headless
import numpy
# Haar cascade files available via data module
# haarcascade_frontalface_default.xml includedVerify before relying
- Specific API surface and function availability in the headless variant
- Performance characteristics compared to standard opencv-python package
- CUDA or GPU acceleration support in this headless build
- Whether all main modules are included or some excluded beyond GUI components
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 | 50,117,128 / month, #576 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_python_headless-5.0.0.93-cp37-abi3-macosx_13_0_arm64.whl; opencv_python_headless-5.0.0.93-cp37-abi3-macosx_14_0_x86_64.whl; opencv_python_headless-5.0.0.93-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; opencv_python_headless-5.0.0.93-cp37-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; opencv_python_headless-5.0.0.93-cp37-abi3-manylinux_2_28_aarch64.whl; opencv_python_headless-5.0.0.93-cp37-abi3-manylinux_2_28_x86_64.whl; opencv_python_headless-5.0.0.93-cp37-abi3-win32.whl; opencv_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 › “face detection classifier”
- opencv-python-headlessOpenCV Python bindings for computer vision tasks, packaged without…
- langidIdentifies the language of text input across 97 languages using a…
- retinaface-pyDetects and localizes faces in images using a PyTorch implementation…
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-contrib-python · opencv-contrib-python-headless · opencv-python · imutils · dlib · albucore · insightface · pyobjc-framework-Vision · pillow-heif · dxcam