NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #5076 most downloaded on PyPI
Build Python wheels on CI with minimal configuration.
Last release 13 days ago
05 Sep 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
5 versions withdrawn
withdrawn after publishing
10 years old
154 releases · first in 2017
🛠 Dependency updates, including CPython 3.8.3 & manylinux images.
25 May 2020
🛠 Dependency updates, including CPython 3.8.3 & manylinux images.
🛠 Lots of internal updates - type annotations and checking using mypy, and a new integration testing system.
⚠️ Removed support for running cibuildwheel using Python 3.5. cibuildwheel will continue to build Python 3.5 wheels until EOL.
🐛 Fix a bug causing programs running inside the i686 manylinux images to think they were running x86_64 and target the wrong architecture. (#336,
4 May 2020
One column per quarter.
🌟 Deterministic builds. cibuildwheel now locks the versions of the tools it uses. This means that pinning your version of cibuildwheel pins the versio
2 May 2020
This can be controlled using the CIBW_DEPENDENCY_VERSIONS and manylinux image options - if you always want to use the latest toolchain, you can still do that, or you can specify your own pip constraints file and manylinux image. (#256)
Note that this change makes the working directory (where you call cibuildwheel from) relevant on Linux, as it's considered the 'project' and will be copied into the Docker container. If your builds are slower on this version, that's likely the reason. cd to your project and then call cibuildwheel from there. (#319, #295)
🛠 On macOS, we make MACOSX_DEPLOYMENT_TARGET default to 10.9 if it's not set. This should make things more consistent between Python versions.
🛠 Dependency updates - CPython 3.7.7, CPython 2.7.18, Pypy 7.3.1.
🌟 Add support for building on GitHub Actions! Check out the docs for information on how to set it up.
12 March 2020
🌟 Add support for building on GitHub Actions! Check out the docs for information on how to set it up. (#194)
✨ Add the CIBW_BEFORE_TEST option, which lets you run a command to prepare the environment before your tests are run. (#242)
🌟 Add support for building PyPy wheels, across Manylinux, macOS, and Windows.
8 March 2020
🌟 Add support for building PyPy wheels, across Manylinux, macOS, and Windows. (#185)
🌟 Added the ability to build ARM64 (aarch64), ppc64le, and s390x wheels, using manylinux2014 and Travis CI. (#273)
✨ You can now build macOS wheels on Appveyor. (#230)
🛠 Changed default macOS minimum target to 10.9, from 10.6. This allows the use of more modern C++ libraries, among other things. (#156)
🛠 Stop building universal binaries on macOS. We now only build x86_64 wheels on macOS. (#220)
✨ Allow chaining of commands using && and || on Windows inside CIBW_BEFORE_BUILD and CIBW_TEST_COMMAND. (#293)
🛠 Improved error reporting for failed Cython builds due to stale .so files (#263)
🛠 Update CPython from 3.7.5 to 3.7.6 and from 3.8.0 to 3.8.2 on Mac/Windows
🛠 Improved error messages when a bad config breaks cibuildwheel's PATH variable. (#264)
⚠️ Removed support for running cibuildwheel on Python 2.7. cibuildwheel will continue to build Python 2.7 wheels for a little while. (#265)
🌟 Add support for building manylinux2014 wheels. To use, set CIBW_MANYLINUX_X86_64_IMAGE and CIBW_MANYLINUX_I686_IMAGE to manylinux2014 .
7 December 2019
🌟 Add support for building manylinux2014 wheels. To use, set CIBW_MANYLINUX_X86_64_IMAGE and CIBW_MANYLINUX_I686_IMAGE to manylinux2014 .
✨ Add support for Linux on Appveyor (#204, #207)
✨ Add CIBW_REPAIR_WHEEL_COMMAND env variable, for changing how auditwheel or delocate are invoked, or testing an equivalent on Windows. (#211)
📚 Added some travis example configs - these are available in /examples. (#228)
🌟 Add support for building Python 3.8 wheels!
10 November 2019
🌟 Add support for building Python 3.8 wheels! (#180)
🌟 Add support for building manylinux2010 wheels. cibuildwheel will now build using the manylinux2010 images by default. If your project is still manylinux1 compatible, you should get both manylinux1 and manylinux2010 wheels - you can upload both to PyPI. If you always require manylinux1 wheels, you can build using the old manylinux1 image using the manylinux image option. (#155)
📚 Documentation is now on its own mini-site , rather than on the README (#169)
✨ Add support for building Windows wheels on Travis CI. (#160)
🛠 If you set CIBW_TEST_COMMAND , your tests now run in a virtualenv. (#164)
🛠 Windows now uses Python as installed by nuget, rather than the versions installed by the various CI providers. (#180)
🛠 Update Python from 2.7.16 to 2.7.17 and 3.7.4 to 3.7.5 on macOS (#171)
⚠️ Removed support for Python 3.4 (#168)
✨ Add CIBW_TEST_EXTRAS option, to allow testing using extra_require options. For example, set CIBW_TEST_EXTRAS=test,qt to make the wheel installed wit
29 September 2019
✨ Add CIBW_TEST_EXTRAS option, to allow testing using extra_require options. For example, set CIBW_TEST_EXTRAS=test,qt to make the wheel installed with pip install <wheel_file>[test,qt]
🛠 Update Python from 3.7.2 to 3.7.4 on macOS
🛠 Update OpenSSL patch to 1.0.2t on macOS
🐛 Fix missing file in the release tarball, that was causing problems with Windows builds
28 May 2019
🌟 Add support for building on Azure pipelines! This lets you build all Linux, Mac and Windows wheels on one service, so it promises to be the easiest
26 May 2019
🌟 Add support for building on Azure pipelines! This lets you build all Linux, Mac and Windows wheels on one service, so it promises to be the easiest to set up! Check out the quickstart in the docs, or cibuildwheel-azure-example for an example project. (#126, #132)
🛠 Internal change - the end-to-end test projects format was updated, so we can more precisely assert what should be produced for each one. (#136, #137).
🛠 Revert temporary fix in macOS, that was working around a bug in pip 19
10 March 2019
🛠 Revert temporary fix in macOS, that was working around a bug in pip 19 (#129)
🛠 Update Python to 2.7.16 on macOS
🛠 Update OpenSSL patch to 1.0.2r on macOS
🐛 Fix build stalling on macOS (that was introduced in pip 19)
3 February 2019
🐛 Fix build stalling on macOS (that was introduced in pip 19) (#122)
🐛 Fix "AttributeError: 'Popen' object has no attribute 'args'" on Python 2.7 for Linux builds (#108)
🛠 Update Python from 3.6.7, 3.7.1 to 3.6.8, 3.7.2 on macOS
🛠 Update openssl patch from 1.0.2p to 1.0.2q on macOS
🛠 Sorting build options dict items when printing preamble (#114)
🌟 Add CIBW_BUILD option, for specifying which specific builds to perform
23 September 2018
🌟 Add CIBW_BUILD option, for specifying which specific builds to perform (#101)
🌟 Add support for building Mac and Linux on CircleCI (#91, #97)
🛠 Improved support for building universal wheels (#95)
🛠 Ensure log output is unbuffered and therefore in the correct order (#92)
🛠 Improved error reporting for errors that occur inside a package's setup.py (#88)
⚠️ Removed support for Python 3.3 on Windows.
🛠 CIBW_TEST_COMMAND now runs in a shell on Mac (as well as Linux)
29 July 2018
⚠️ Deprecated support for Python 3.3 on Windows.
10 July 2018
🛠 Update to Python 3.6.6 on macOS (#82)
✨ Add support for building Python 3.7 wheels on Windows (#76)
⚠️ Deprecated support for Python 3.3 on Windows.
🛠 Update Python 3.7.0rc1 to 3.7.0 on macOS
1 July 2018
🛠 Removed the need to use {python} and {pip} in CIBW_BEFORE_BUILD statements, by ensuring the correct version is always on the path at python and pip
18 June 2018
🛠 Removed the need to use {python} and {pip} in CIBW_BEFORE_BUILD statements, by ensuring the correct version is always on the path at python and pip instead. (#60)
🛠 We now patch the _ssl module on Python 3.4 and 3.5 so these versions can still make SSL web requests using TLS 1.2 while building. (#71)
18 June 2018 - ✨ Add support for Python 3.7
18 June 2018
⚠️ Drop support for Python 3.3 on Linux
4 May 2018
⚠️ Drop support for Python 3.3 on Linux (#67)
🐛 Fix TLS by updating setuptools (#69)
Nothing published for this version
🐛 macOS: Fix Pip bugs resulting from PyPI TLS 1.2 enforcement
2 April 2017
🐛 macOS: Fix Pip bugs resulting from PyPI TLS 1.2 enforcement
🐛 macOS: Fix brew Python3 version problems in the CI
✨ You can now specify a custom docker image using the CIBW_MANYLINUX1_X86_64_IMAGE and CIBW_MANYLINUX1_I686_IMAGE options.
7 January 2018
✨ You can now specify a custom docker image using the CIBW_MANYLINUX1_X86_64_IMAGE and CIBW_MANYLINUX1_I686_IMAGE options. (#46)
🐛 Fixed a bug where cibuildwheel would download and build a package from PyPI(!) instead of building the package on the local machine. (#51)
✨ On the Linux build, the host filesystem is now accessible via /host
9 October 2017
✨ On the Linux build, the host filesystem is now accessible via /host (#36)
🐛 Fixed a bug where setup.py scripts would run the wrong version of Python when running subprocesses on Linux (#35)
🐛 Fixed a couple of bugs on Python 3.
10 September 2017
🐛 Fixed a couple of bugs on Python 3.
✨ Added experimental support for Mac builds on Bitrise.io
✨ CIBW_ENVIRONMENT added. You can now set environment variables for each build, even within the Docker container on Linux. This is a big one!
7 September 2017
✨ CIBW_ENVIRONMENT added. You can now set environment variables for each build, even within the Docker container on Linux. This is a big one! (#21)
✨ CIBW_BEFORE_BUILD now runs in a system shell on all platforms. You can now do things like CIBW_BEFORE_BUILD="cmd1 && cmd2" . (#32)
🐛 Fixed a bug on Windows where subprocess' output was hidden
14 August 2017
🐛 Fixed a bug on Windows where subprocess' output was hidden (#23)
🐛 Fixed a bug on AppVeyor where logs would appear in the wrong order due to output buffering (#24, thanks @YannickJadoul!)
🐛 Fixed a bug that was increasing the build time by building the wheel twice. This was a problem for large projects that have a long build time. If yo
23 July 2017
⚠️ Removed Python 2.6 support on Linux
27 June 2017
🛠 Changed the build process to install the package before building the wheel - this allows direct dependencies to be installed first (#9, thanks @tgar
11 June 2017
🛠 Changed the build process to install the package before building the wheel - this allows direct dependencies to be installed first (#9, thanks @tgarc!)
✨ Added Python 3 support for the main process, for systems where Python 3 is the default (#8, thanks @tgarc).
✨ Added CIBW_SKIP option, letting users explicitly skip a build
13 April 2017
✨ Added CIBW_SKIP option, letting users explicitly skip a build
✨ Added CIBW_BEFORE_BUILD option, letting users run a shell command before the build starts
31 March 2017 - 🌟 First public release!
31 March 2017
31 March 2017
<style>
/* improve list formatting to help separate items */
.rst-content li { margin-bottom: 12px; } .rst-content .section ol li>p:only-child, .rst-content .section ol li>p:only-child:last-child, .rst-content .section ul li>p:only-child, .rst-content .section ul li>p:only-child:last-child, .rst-content .toctree-wrapper ol li>p:only-child, .rst-content .toctree-wrapper ol li>p:only-child:last-child, .rst-content .toctree-wrapper ul li>p:only-child, .rst-content .toctree-wrapper ul li>p:only-child:last-child, .rst-content section ol li>p:only-child, .rst-content section ol li>p:only-child:last-child, .rst-content section ul li>p:only-child, .rst-content section ul li>p:only-child:last-child { margin-bottom: 12px } </style>
<script> // undo the scrollTop that the theme did on this page, as there are loads // of toc entries and it's disorientating. window.addEventListener('DOMContentLoaded', function() { $('.wy-nav-side').scrollTop(0) }) </script>
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →