{"id":17182424,"url":"https://github.com/bertsky/wrap_opencv-python-headless","last_synced_at":"2025-07-08T03:35:22.517Z","repository":{"id":118132905,"uuid":"301691810","full_name":"bertsky/wrap_opencv-python-headless","owner":"bertsky","description":"rebrand opencv-python-headless","archived":false,"fork":false,"pushed_at":"2020-10-06T19:34:03.000Z","size":3,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-18T21:45:47.625Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bertsky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-10-06T10:35:14.000Z","updated_at":"2024-06-25T21:21:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"bd1d7f8a-a642-40d9-b4fb-f2f22d4764fc","html_url":"https://github.com/bertsky/wrap_opencv-python-headless","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bertsky/wrap_opencv-python-headless","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertsky%2Fwrap_opencv-python-headless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertsky%2Fwrap_opencv-python-headless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertsky%2Fwrap_opencv-python-headless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertsky%2Fwrap_opencv-python-headless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bertsky","download_url":"https://codeload.github.com/bertsky/wrap_opencv-python-headless/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bertsky%2Fwrap_opencv-python-headless/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264190887,"owners_count":23570597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-15T00:37:03.568Z","updated_at":"2025-07-08T03:35:22.512Z","avatar_url":"https://github.com/bertsky.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wrap_opencv-python-headless\n    rebrand opencv-python-headless as opencv-python\n\n## Introduction\n\nIf you want to install [OpenCV](https://github.com/skvark/opencv-python.git) as a Python package, or include it as a dependency in another, (unless you want to build your own,) you'll first have to decide on a _flavour_ (and top-level package name):\n\n\u003e Select the correct package for your environment:\n\n\u003e There are four different packages (see options 1, 2, 3 and 4 below) and you should **SELECT ONLY ONE OF THEM**. Do not install multiple different packages in the same environment. There is no plugin architecture: all the packages use the same namespace (`cv2`). If you installed multiple different packages in the same environment, uninstall them all with ``pip uninstall`` and reinstall only one package.\n\n\u003e **a.** Packages for standard desktop environments (Windows, macOS, almost any GNU/Linux distribution)\n\n\u003e   - Option 1 - Main modules package: ``pip install opencv-python``\n\u003e   - Option 2 - Full package (contains both main modules and contrib/extra modules): ``pip install opencv-contrib-python`` (check contrib/extra modules listing from [OpenCV documentation](https://docs.opencv.org/master/))\n\n\u003e **b.** Packages for server (headless) environments (such as Docker, cloud environments etc.), no GUI library dependencies\n\n\u003e These packages are smaller than the two other packages above because they do not contain any GUI functionality (not compiled with Qt / other GUI components). This means that the packages avoid a heavy dependency chain to X11 libraries and you will have for example smaller Docker images as a result. You should always use these packages if you do not use `cv2.imshow` et al. or you are using some other package (such as PyQt) than OpenCV to create your GUI.\n\n\u003e - Option 3 - Headless main modules package: ``pip install opencv-python-headless``\n\u003e - Option 4 - Headless full package (contains both main modules and contrib/extra modules): ``pip install opencv-contrib-python-headless`` (check contrib/extra modules listing from [OpenCV documentation](https://docs.opencv.org/master/))\n\nThis creates a problem for dependent packages, though: Whatever OpenCV flavour you choose to depend on, your dependents will also rely on that particular choice. To make matters worse, `pip` does not consider these flavours as conflict when installed in parallel (despite all sharing the same submodule/subpackage name `cv2`).\n\nSo practically, if you depend on some OpenCV-dependent packages, but want to avoid the X11 dependencies, _any_ of your dependencies could drag them back in if it chose to require `opencv-python` instead of `opencv-python-headless`.\n\nIf, however, you know for certain that none of them _actually_ need X11, and might thus easily have been chosen `headless`, then this package is for you. It merely re-brands `opencv-python-headless` as `opencv-python` by requiring the former but providing the latter in an otherwise empty package.\n\nYou can install this package _prior_ to other dependencies and thus block any subsequent installation of the actual prebuilt `opencv-python`. (But to make this work including a mirrored version number, `opencv-python-headless` needs to be installed early, too. Thus, installing this package will also install `opencv-python-headless` if not already present.)\n\n## Installation\n\n    # git clone and chdir, then pip:\n    pip install .\n    # or, pip via git:\n    pip install opencv-python@git+https://github.com/bertsky/wrap_opencv-python-headless\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbertsky%2Fwrap_opencv-python-headless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbertsky%2Fwrap_opencv-python-headless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbertsky%2Fwrap_opencv-python-headless/lists"}