pyinstaller-hooks-contrib
Community maintained hooks for PyInstaller
Decision gist · record as of 2026-08-14
Yes. Install this automatically when you install PyInstaller (it's a dependency), or explicitly if you're bundling applications with packages that need hooks. The package is actively maintained, has no known vulnerabilities, and low install friction. The only caveat is the unclear license metadata—verify the actual license terms match your project's requirements before use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or later.
- Hooks only apply to packages for which they have been contributed; unsupported packages may still fail to bundle correctly.
- Low friction installation with only two lightweight runtime dependencies (importlib_metadata and packaging).
License · maintenance · safety
(unclear) — License treatment is unclear—the package declares both Apache and GPL v2 classifiers but provides no explicit SPDX or raw license metadata. Verify the actual license terms before use in proprietary or restricted-license projects.
last release 2026-06-08 (67 days) · last repo commit 2026-08-10 · 122 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 11,545,181 downloads/mo, #1,383 on PyPI
Alternatives
Verify before relying
pip install pyinstaller-hooks-contrib
# Hooks are automatically discovered by PyInstaller when installed
# Use PyInstaller normally; hooks for supported packages apply automatically
pyinstaller --onefile your_script.py- Whether all hooks are actively maintained and tested across current Python versions
- Coverage of which specific packages have hooks available and how complete those hooks are
- Whether the Apache and GPL v2 license declarations are both accurate or if one is the primary license
What it is and what it does
PyInstaller-hooks-contrib is a repository of community-contributed hooks that teach PyInstaller how to handle third-party packages that don't bundle correctly on their own. When PyInstaller encounters a package, it doesn't automatically know about that package's data files, hidden imports, or special runtime setup—hooks fill that gap by specifying what should be included in the final bundled application. The package installs as a dependency alongside PyInstaller and is automatically discovered; hooks are applied without requiring explicit configuration.
Hooks come in two forms: standard hooks (which tell PyInstaller what to include in the bundle) and runtime hooks (which set up the environment when the bundled app starts). The repository collects hooks for many popular packages, allowing developers to use PyInstaller with libraries that would otherwise fail to bundle. If a package doesn't have a hook, either it works fine without one or the community hasn't contributed one yet.
Use it for
- Bundle a Python application that uses a third-party library with data files or hidden imports that PyInstaller can't detect automatically.
- Create standalone executables from scripts that depend on packages known to have compatibility issues with PyInstaller.
- Contribute a hook for a package you maintain or use frequently to help other developers bundle applications with it.
- Ensure runtime environment setup (e.g., library paths, configuration) is correct when PyInstaller launches a bundled app.
- Maintain compatibility across multiple Python versions and platforms when distributing PyInstaller-based applications.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Install this automatically when you install PyInstaller (it's a dependency), or explicitly if you're bundling applications with packages that need hooks. The package is actively maintained, has no known vulnerabilities, and low install friction. The only caveat is the unclear license metadata—verify the actual license terms match your project's requirements before use.
Install
pyinstaller-hooks-contrib on PyPI
Before you install
Low friction installation with only two lightweight runtime dependencies (importlib_metadata and packaging). Actively maintained with a recent release; last commit was 2026-08-10 and the project has 122 stars.
Requires Python 3.8 or later. Hooks only apply to packages for which they have been contributed; unsupported packages may still fail to bundle correctly.
License in practice
License treatment is unclear—the package declares both Apache and GPL v2 classifiers but provides no explicit SPDX or raw license metadata. Verify the actual license terms before use in proprietary or restricted-license projects.
Quickstart
pip install pyinstaller-hooks-contrib
# Hooks are automatically discovered by PyInstaller when installed
# Use PyInstaller normally; hooks for supported packages apply automatically
pyinstaller --onefile your_script.pyVerify before relying
- Whether all hooks are actively maintained and tested across current Python versions
- Coverage of which specific packages have hooks available and how complete those hooks are
- Whether the Apache and GPL v2 license declarations are both accurate or if one is the primary license
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesimportlib_metadatapackaging |
| Maintenance | Actively maintained 67 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 11,545,181 / month, #1,383 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseLicense :: OSI Approved :: GNU General Public License v2 (GPLv2)Natural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Topic :: Software Development :: Build Tools |
Evidence: pyinstaller_hooks_contrib-2026.6-py3-none-any.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 › “pyinstaller hooks”
- pyinstaller-hooks-contribProvides community-maintained hooks that extend PyInstaller to bundle…
- types-pyinstallerProvides type stubs for pyinstaller, enabling type checkers like mypy…
- pyinstxtractor-ngExtracts Python bytecode and resources from PyInstaller-generated…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also types-pyinstaller · pyinstaller · pyinstxtractor-ng · pyinstaller-versionfile · pre-commit-hooks · tkinterdnd2 · mkdocs-simple-hooks · auto-py-to-exe · pyproject-hooks · hatchling-autoextras-hook