---
id: repairwheel
version: "0.6.2"
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)
license_treatment: permissive
maintenance: active
---

# repairwheel — Repair any wheel, anywhere

License: permissive · Maintenance: active · Downloads: 121.1K/mo

## 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 above — 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

pip install repairwheel
uv add repairwheel
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_current
- Install friction: low
- Maintenance: active
- Downloads: 121.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

wheel repair cross-platform, bundle native dependencies wheel, auditwheel delocate delvewheel, normalize wheel metadata, wheel binary compatibility, wheel platform tags, fix wheel dependencies, wheel-packaging, cross-platform-build

[View on SkillFed](https://skillfed.io/packages/repairwheel) · [View on PyPI](https://pypi.org/project/repairwheel/)