From 13b086e3c6a8a225ee99a028fcf5b820a9d2660f Mon Sep 17 00:00:00 2001 From: tabedzki <35670232+tabedzki@users.noreply.github.com> Date: Fri, 25 Jul 2025 00:46:16 -0400 Subject: [PATCH] docs: clarify language around Python requirements for local `cibuildwheel` usage (#2513) * First set of changes to setup.md * Update docs/setup.md Co-authored-by: Henry Schreiner * Update docs/setup.md Co-authored-by: Joe Rickerby * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Co-authored-by: Henry Schreiner Co-authored-by: Joe Rickerby Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> --- docs/setup.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/setup.md b/docs/setup.md index 03a13491..412acdf0 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -23,6 +23,8 @@ cibuildwheel !!!tip You can pass the `--platform linux` option to cibuildwheel to build Linux wheels, even if you're not on Linux. On most machines, the easiest builds to try are the Linux builds. You don't need any software installed except a Docker daemon, such as [Docker Desktop](https://www.docker.com/get-started/). Each platform that cibuildwheel supports has its own system requirements and platform-specific behaviors. See the [platforms page](platforms.md) for details. + When building locally for macOS or iOS, regardless of the Python you use to invoke cibuildwheel, you'll need [official Python.org](https://www.python.org/downloads/) installations on your machine. `cibuildwheel` won't perform the build using unofficial Python installations such as from `brew` or `uv`. + You should see the builds taking place. You can experiment with [options](options.md) using pyproject.toml or environment variables. !!! tab "pyproject.toml"