Registry / devops / delvewheel

delvewheel

JSON →
library1.13.0pypypi✓ verified 81d ago

Delvewheel is a utility that creates self-contained Python wheels for Windows by embedding external shared libraries (DLLs) into the wheel. This helps to eliminate common 'DLL not found' errors when deploying Python packages on Windows. The current version is 1.12.0, and it is actively maintained with releases tied to necessary updates for Python versions or dependency handling.

pip install delvewheel
INSTALL
IMPORT
SIG · DELVEWHEEL
D
delvewheel
devopspythonv1.13.0
Install
1.6s avg
Import
Disk
17MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.13.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.915 runs
installs and imports cleanly · install 0.0s · import 0.000s · 18.8MB
glibc
py 3.103.915 runs
installs and imports cleanly · install 1.6s · import 0.000s · 19MB
17MB installed
● package 17MB
Code
Verified usage

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

main
import delvewheel
from delvewheel import main

To use delvewheel, you typically invoke it from the command line using `python -m delvewheel repair` followed by the path to your wheel file(s). It will create a new, repaired wheel in the same directory or a specified output directory.

# Assume 'my_package-1.0-cp39-cp39-win_amd64.whl' is a wheel file to be repaired # Run delvewheel from your terminal or command prompt # Basic repair, will attempt to find and embed DLLs python -m delvewheel repair my_package-1.0-cp39-cp39-win_amd64.whl # Repair with custom output directory python -m delvewheel repair --wheel-dir ./repaired_wheels my_package-1.0-cp39-cp39-win_amd64.whl
delvewheel --version
Debug
Known issues
breakingDelvewheel is exclusively for Windows wheels. Attempting to use it on Linux or macOS will result in an error, and it has no functionality for these operating systems.
fix
Ensure you are running delvewheel on a Windows operating system. For Linux wheels, consider `auditwheel`.
affects: All versions
gotchaWheels repaired by delvewheel may still require specific versions of the Visual C++ Redistributables (VCRedist) on the target machine if the original DLLs depend on external VCRedist versions not bundled with Python. Delvewheel primarily embeds MSVC runtime libraries from the Python installation it's run with.
fix
Test your repaired wheels on a clean Windows environment. If VCRedist errors occur, ensure the target machine has the necessary VCRedist installed, or investigate if the original DLLs can be linked against a different runtime.
affects: All versions
gotchaDelvewheel might not find or correctly embed all custom or deeply embedded DLLs, especially those not in standard system paths, relative paths, or those loaded dynamically at runtime in complex ways. It relies on dependency scanning.
fix
If a DLL is consistently missed, try to make it discoverable by adding its directory to the system PATH temporarily during the `delvewheel repair` process or by explicitly specifying its location if the original build process allows.
affects: All versions
gotchaEnsure the Python interpreter running `delvewheel` is compatible with the wheel's target Python version and architecture (e.g., Python 3.9 64-bit for a `cp39-win_amd64` wheel). Incompatibilities can lead to issues with embedding MSVC runtimes or incorrect dependency resolution.
fix
Always use a Python environment matching the wheel's target when running `delvewheel repair`. For example, use a Python 3.9 environment to repair Python 3.9 wheels.
affects: All versions
Upgrade
Version history
1.13.0latest on PyPI · released May 28, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
21 hits · last 30 days
node
20
Resources
delvewheel — pip install delvewheel · libregistry