skillfed

repairwheel

Repair any wheel, anywhere

repairwheel v0.6.2 121.1K downloads/30d#11,996 on PyPI56
Permissive license Copyright © 2023 Jeremy Volkman Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record) Active released

What it is and what it does

repairwheel is a unified wheel repair tool that consolidates the repair logic from auditwheel, delocate, and delvewheel into a single cross-platform interface. It takes a wheel file, inspects its platform tag, applies the appropriate repair strategy for that platform, and outputs a normalized wheel with consistent file ordering, timestamps, and RECORD entries—aiming for bitwise-identical results regardless of the build system.

The tool includes pure-Python replacements for external utilities like patchelf, otool, install_name_tool, and codesign, eliminating the need for system-level dependencies. This makes it practical for CI/CD pipelines and build environments where installing platform-specific tools is inconvenient. It's designed for developers and packagers who need to distribute binary wheels across multiple platforms with minimal friction.

Use it for:

  • Repair a macOS wheel to bundle dylib dependencies and update install names for distribution
  • Convert a Linux wheel to manylinux-compatible format by bundling system libraries
  • Normalize wheel metadata and file ordering for reproducible, bit-identical builds across machines
  • Automate cross-platform wheel repair in CI/CD without installing separate repair tools
  • Repair a Windows wheel to bundle runtime or other dependencies for standalone distribution

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Repairs wheels for cross-platform distribution by bundling native dependencies and normalizing metadata, with pure-Python implementations of platform-specific tools.

Yes, if you package binary extensions for multiple platforms. It consolidates three separate repair tools into one, has low install friction, is actively maintained, carries no known vulnerabilities, and uses a permissive MIT license. Install it if your build pipeline needs cross-platform wheel repair without managing platform-specific external tools.

Install

repairwheel on PyPI

pip

pip install repairwheel

uv

uv add repairwheel

poetry

poetry add repairwheel

Installing repairwheel

Before you install

Low friction install with five runtime dependencies. Actively maintained as of 2026-07-20 with recent releases.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions.

Quickstart

pip install repairwheel
repairwheel input-wheel.whl -o /tmp/wheelout

Requires Python 3.10 or later

Verify before relying

  • Whether the pure-Python tool implementations cover all edge cases that external tools handle
  • Performance characteristics compared to using auditwheel, delocate, or delvewheel individually

Package facts

License Copyright © 2023 Jeremy Volkman Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record) (permissive)
Python support supports the current Python release (>=3.10)
Install friction low — pure-Python wheel
Runtime dependencies 5 — delvewheel, macholib, packaging, pefile, pyelftools
Maintenance actively maintained — 52 days since the last release
Last repo commit
First released
Downloads 121,085/month — #11,996 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: repairwheel-0.6.2-py3-none-any.whl

License :: OSI Approved :: MIT LicenseProgramming 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 :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy

Tags

wheel repair cross-platformbundle native dependencies wheelauditwheel delocate delvewheelnormalize wheel metadatawheel binary compatibilitywheel platform tagsfix wheel dependencies
wheel-packagingcross-platform-build

More Build Tools packages