auditwheel
Cross-distribution Linux wheels
Decision gist · record as of 2026-08-14
Yes, if you build and distribute Python wheels with compiled extensions on Linux. auditwheel is the standard tool for ensuring those wheels work across many Linux distributions without requiring users to have matching system libraries. Install it in your build pipeline or development environment. Not needed if you only use pure-Python wheels or pre-built wheels from others.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Linux OS with ELF-based linkage, Python 3.10+, and patchelf 0.14+ installed on the system.
- Low friction installation with only two runtime dependencies (packaging and pyelftools).
- Active maintenance with a recent release; requires Python 3.10+ and the external system tool patchelf 0.14+.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) places no significant restrictions on use, modification, or distribution of code that depends on auditwheel.
last release 2026-08-10 (4 days) · last repo commit 2026-08-14 · 530 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,891,173 downloads/mo, #3,461 on PyPI
Alternatives
Verify before relying
pip install auditwheel
auditwheel show mypackage-1.0-linux_x86_64.whl
auditwheel repair mypackage-1.0-linux_x86_64.whl- Whether the tool works correctly with all supported Python versions or if there are known compatibility gaps.
- Performance characteristics when repairing wheels with many external dependencies.
- Whether dynamic library loading via ctypes/cffi/dlopen is reliably detected or if the documented limitation is absolute.
What it is and what it does
auditwheel is a command-line tool for making Python wheels containing compiled binary extensions compatible across many Linux distributions. It works by inspecting wheels to identify external shared library dependencies and versioned symbols that fall outside manylinux policy compliance, then bundling those libraries into the wheel itself and adjusting runtime paths so they are found at load time. This achieves the effect of static linking without requiring changes to the original build system.
The tool operates in two main modes: `auditwheel show` audits a wheel to report which external libraries it depends on and what compliance issues exist, while `auditwheel repair` performs the actual bundling and relabeling. It is designed for package maintainers building wheels in controlled environments (typically manylinux Docker images) to ensure their binary packages work on a wide range of Linux systems.
Use it for
- Repair a compiled extension wheel to meet manylinux1, manylinux2010, manylinux2014, or manylinux_x_y platform tag requirements.
- Audit a wheel before distribution to identify external library dependencies and ABI compatibility issues.
- Bundle third-party shared libraries into a wheel for portable binary distribution across Linux systems.
- Convert a Linux wheel to an Android wheel by relabeling and adjusting dependencies per PEP 738.
- Verify that a wheel's external dependencies conform to a specific manylinux policy before uploading to PyPI.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you build and distribute Python wheels with compiled extensions on Linux.
auditwheel is the standard tool for ensuring those wheels work across many Linux distributions without requiring users to have matching system libraries. Install it in your build pipeline or development environment. Not needed if you only use pure-Python wheels or pre-built wheels from others.
Install
auditwheel on PyPI
Before you install
Low friction installation with only two runtime dependencies (packaging and pyelftools). Active maintenance with a recent release; requires Python 3.10+ and the external system tool patchelf 0.14+.
Requires Linux OS with ELF-based linkage, Python 3.10+, and patchelf 0.14+ installed on the system.
License in practice
MIT license (permissive) places no significant restrictions on use, modification, or distribution of code that depends on auditwheel.
Quickstart
pip install auditwheel
auditwheel show mypackage-1.0-linux_x86_64.whl
auditwheel repair mypackage-1.0-linux_x86_64.whlVerify before relying
- Whether the tool works correctly with all supported Python versions or if there are known compatibility gaps.
- Performance characteristics when repairing wheels with many external dependencies.
- Whether dynamic library loading via ctypes/cffi/dlopen is reliably detected or if the documented limitation is absolute.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespackagingpyelftools |
| Maintenance | Actively maintained 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,891,173 / month, #3,461 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: POSIX :: LinuxProgramming 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.14Topic :: Software DevelopmentTopic :: Software Development :: Build ToolsTopic :: Software Development :: Libraries :: Python Modules |
Evidence: auditwheel-6.8.0-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 › “manylinux wheel compatibility”
- auditwheelAudits and repairs Linux and Android wheel packages to ensure…
- patchelfProvides a PyPI-packaged binary of patchelf, a utility for modifying…
- cibuildwheelAutomates building and testing Python wheels across multiple…
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 patchelf · repairwheel · cibuildwheel · abi3audit · delvewheel · wheel · change-wheel-version · libucx-cu12 · cmeel · wheel-filename