Implementation:Ray project Ray Build Wheel Scripts
| Knowledge Sources | |
|---|---|
| Domains | Build_Systems, Packaging |
| Last Updated | 2026-02-13 17:00 GMT |
Overview
External tool documentation for the platform-specific wheel build scripts that produce Ray Python wheel files.
Description
A set of bash scripts builds Ray wheels for different platforms:
- build-wheel.sh (L1-28): Top-level wrapper using uv run to invoke the wheel builder
- python/build-wheel-macos.sh (L1-94): macOS builds using conda environments
- python/build-wheel-manylinux2014.sh (L1-70): Linux builds in manylinux containers
- python/build-wheel-windows.sh (L1-120): Windows builds with delvewheel for DLL fixup
python/setup.py (L531-678) orchestrates Bazel targets and Cython compilation.
Usage
Run the appropriate platform script in CI. Controlled by environment variables like BUILD_ONE_PYTHON_ONLY and RAY_INSTALL_CPP.
Code Reference
Source Location
- Repository: ray-project/ray
- File: build-wheel.sh (L1-28)
- File: python/build-wheel-macos.sh (L1-94)
- File: python/build-wheel-manylinux2014.sh (L1-70)
- File: python/build-wheel-windows.sh (L1-120)
- File: python/setup.py (L531-678)
Signature
./build-wheel.sh
./python/build-wheel-macos.sh
./python/build-wheel-manylinux2014.sh
./python/build-wheel-windows.sh
I/O Contract
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| Source code | Git repo | Yes | Full Ray source tree |
| BUILD_ONE_PYTHON_ONLY | Env var | No | Build for a single Python version |
| RAY_INSTALL_CPP | Env var | No | Also build ray-cpp wheel |
Outputs
| Name | Type | Description |
|---|---|---|
| .whl files | Files | ray-{version}-cp{ver}-cp{ver}-{platform}.whl per Python version |
Usage Examples
Build Linux Wheels
# Inside manylinux container
./python/build-wheel-manylinux2014.sh
Related Pages
Implements Principle
Requires Environment
Page Connections
Double-click a node to navigate. Hold to expand connections.
Principle
Implementation
Heuristic
Environment