repairwheel

library0.6.0pypypi✓ verified 86d ago

A modern cross-platform CLI & library to repair Python wheels (auditwheel for macOS/Linux/Windows, delocate for macOS, wheel-fix for Windows). Version 0.6.0, active development, roughly monthly releases.

devops

pip install repairwheel

INSTALL

IMPORT

SIG · REPAIRWHEEL

repairwheel

devopspythonv0.6.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

repair

✓ from repairwheel import repair

✗ import repair

repair is not a top-level module; must import from repairwheel

fix_wheel

✓ from repairwheel import fix_wheel

✗ from repairwheel import repair_wheel

The function is named fix_wheel, not repair_wheel

Policy

✓ from repairwheel.policies import Policy

✗ from repairwheel import Policy

Policy class lives in the policies submodule

Repair a wheel by bundling external shared libraries and updating the wheel tag.

from repairwheel import repair repair('mywheel-1.0-cp310-cp310-linux_x86_64.whl', policy='manylinux2014') print('Wheel repaired successfully')

Debug

Known issues

breakingIn repairwheel 0.6.0, the CLI command changed from `repairwheel repair` to `python -m repairwheel`.

fix

Use `python -m repairwheel <wheel>` instead of `repairwheel repair <wheel>`.

affects: >=0.6.0

deprecatedUsing raw 'Policy' strings without importing from policies is deprecated in 0.5.0+.

fix

Import Policy from repairwheel.policies and use Policy objects instead of strings.

affects: >=0.5.0

gotcharepairwheel only works on Linux when repairing to manylinux tags – it requires patchelf. On macOS, it requires install_name_tool. Without these, wheel repair will fail silently or produce broken wheels.

fix

Ensure patchelf (Linux) or Xcode command line tools (macOS) are installed before running repairwheel.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'repairwheel'

repairwheel not installed or installed in a different Python environment.

fix

Run `pip install repairwheel` in the correct environment.

AttributeError: module 'repairwheel' has no attribute 'repair_wheel'

Using outdated function name `repair_wheel` instead of `repair`.

fix

Use `from repairwheel import repair` and call `repair(...)`.

ValueError: Unknown policy 'manylinux1'

Policy 'manylinux1' is deprecated and no longer supported in repairwheel 0.6.0.

fix

Use 'manylinux2014' or 'manylinux_2_28' instead.

repairwheel: error: the following arguments are required: WHEEL

Running CLI without specifying the wheel file.

fix

Run as `python -m repairwheel path/to/wheel.whl`.

Upgrade

Version history

0.6.0latest on PyPI · released Jun 1, 2026

Audit

Dependencies

wheelrequiredRequired for wheel inspection and repackaging

Agent activity

4 hits · last 30 days

node

Resources

No resource links recorded.