delvewheel

What it is and what it does

delvewheel is a command-line tool that solves the problem of distributing Python wheels for Windows when they depend on DLLs not guaranteed to be present on end-user machines. It inspects a wheel, identifies external DLL dependencies (excluding system libraries), copies those DLLs into the wheel, and patches the wheel so the DLLs load correctly at runtime. This approach mirrors auditwheel (Linux) and delocate (macOS).

The tool handles DLL name mangling to avoid DLL hell—a Windows problem where multiple versions of the same DLL can conflict. It supports fine-grained control via command-line options to include or exclude specific DLLs, search additional paths, and configure where vendored DLLs are stored within the wheel. It runs on Python 3.9+ and can repair wheels targeting Python 2.6 or later across win32, win_amd64, and win_arm64 architectures.

Use it for:

• Package a compiled extension module with its required DLL dependencies for clean installation on Windows systems.
• Repair an existing wheel by automatically discovering and bundling external DLL dependencies into a self-contained distribution.
• Inspect a wheel to see which external DLLs it depends on before deciding whether to bundle them.
• Produce Windows wheels from a Linux or macOS build environment without needing a Windows machine.
• Manage DLL namespace conflicts by using name-mangling and selective exclusion options.

Worth the install?

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

Bundles DLL dependencies into Windows Python wheels to create self-contained packages that work without requiring system libraries on the target machine.

Yes. delvewheel fills a critical gap for Windows wheel distribution. It is actively maintained, has low install friction, carries a permissive MIT license, and solves a real problem for anyone shipping compiled Python packages for Windows. The tool is stable (Production/Stable classifier), has no known vulnerabilities, and is popular (433256 monthly downloads, top 15000 packages) indicating real-world adoption.

Install

delvewheel on PyPI

pip install delvewheel

uv add delvewheel

poetry add delvewheel

Installing delvewheel

Before you install

Low friction install with a single runtime dependency (pefile). Active maintenance with recent releases; last commit 2026-08-14 and 152 repository stars indicate ongoing support.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may redistribute the tool and wheels it produces under the same terms.

Quickstart

pip install delvewheel
delvewheel repair mywheel-0.0.1-cp310-cp310-win_amd64.whl
delvewheel show mywheel-0.0.1-cp310-cp310-win_amd64.whl

Requires Python 3.9+ to run; wheels being repaired can target Python 2.6+ on win32, win_amd64, or win_arm64.

Verify before relying

• Whether delvewheel can repair Windows wheels from non-Windows build environments as the description suggests.
• Performance characteristics when processing large wheels with many DLL dependencies.

Package facts

Evidence: delvewheel-1.13.0-py3-none-any.whl

Tags

More Software Development packages