Skip to content

Quickly sandbox your AI agent.

Python

fix(build): use manylinux_2_17 platform tags for Linux wheels

Tyler Payne306c3b574df1
diff --git a/docs/under-the-hood/01-installation.md b/docs/under-the-hood/01-installation.md
index d565498..32bb21b 100644
--- a/docs/under-the-hood/01-installation.md
+++ b/docs/under-the-hood/01-installation.md
@@ -70,8 +70,8 @@ quicksand-qemu is in `_SKIP` — never retagged. Each runner produces exactly on
| Runner | QEMU Binary | Wheel Tag | After `pre_release` merge |
|--------|-------------|-----------|--------------------------|
-| `[linux, x64]` | qemu-system-x86_64 (Linux) | `linux_x86_64` | unchanged |
-| `[linux, arm64]` | qemu-system-aarch64 (Linux) | `linux_aarch64` | unchanged |
+| `[linux, x64]` | qemu-system-x86_64 (Linux) | `manylinux_2_17_x86_64` | unchanged |
+| `[linux, arm64]` | qemu-system-aarch64 (Linux) | `manylinux_2_17_aarch64` | unchanged |
| `[macos, arm64]` | qemu-system-aarch64 (macOS) | `macosx_11_0_arm64` | unchanged |
| `[windows, x64]` | qemu-system-x86_64.exe | `win_amd64` | → **fat**: x64 in `bin/x86_64/`, arm64 in `bin/arm64/` |
| `[windows, arm64]` | qemu-system-aarch64.exe | `win_arm64` ¹ | unchanged (consumed by merge into fat wheel) |
diff --git a/packages/dev/quicksand-build-tools/quicksand_build_tools/__init__.py b/packages/dev/quicksand-build-tools/quicksand_build_tools/__init__.py
index 4d108ea..acbdfa0 100644
--- a/packages/dev/quicksand-build-tools/quicksand_build_tools/__init__.py
+++ b/packages/dev/quicksand-build-tools/quicksand_build_tools/__init__.py
@@ -175,6 +175,10 @@ class BinaryBundler:
except Exception:
pass
+ # PyPI requires manylinux tags for Linux wheels (PEP 600)
+ if platform_tag.startswith("linux_"):
+ platform_tag = platform_tag.replace("linux_", "manylinux_2_17_", 1)
+
build_data["tag"] = f"py3-none-{platform_tag}"
def force_include_bin_dir(self, bin_dir: Path, root: Path, build_data: dict) -> None:
diff --git a/packages/dev/quicksand-image-tools/quicksand_image_tools/build_utils.py b/packages/dev/quicksand-image-tools/quicksand_image_tools/build_utils.py
index f83be3b..d74d595 100644
--- a/packages/dev/quicksand-image-tools/quicksand_image_tools/build_utils.py
+++ b/packages/dev/quicksand-image-tools/quicksand_image_tools/build_utils.py
@@ -51,5 +51,9 @@ def set_platform_wheel_tag(
if native_arch == "arm64" and "win_amd64" in platform_tag:
platform_tag = "win_arm64"
+ # PyPI requires manylinux tags for Linux wheels (PEP 600)
+ if platform_tag.startswith("linux_"):
+ platform_tag = platform_tag.replace("linux_", "manylinux_2_17_", 1)
+
build_data["tag"] = f"py3-none-{platform_tag}"
return True