Skip to content

Commit 8e40d06

Browse files
Add XPU build script
1 parent 53328b4 commit 8e40d06

3 files changed

Lines changed: 532 additions & 2 deletions

File tree

README.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,25 @@ The install script installs system dependencies along with torchforge. Note that
6363

6464
Optional: By default, the packages installation uses conda. If you want to install system packages on the target machine instead of conda, you can pass the `--use-sudo` flag to the installation script: `./scripts/install.sh --use-sudo`.
6565

66+
### XPU Installation
67+
68+
XPU (Intel GPU) users can install with the dedicated script:
69+
70+
```bash
71+
conda create -n forge python=3.12
72+
conda activate forge
73+
./scripts/install_xpu.sh
74+
```
75+
76+
Notes:
77+
- Requires Intel oneAPI toolkit installed at `$ONEAPI_ROOT`, `/opt/intel/oneapi`, or loadable via `module load intel/oneapi`.
78+
- Python version must match `IPEX_PYTHON_VERSION` in `assets/versions.sh`.
79+
- The script installs PyTorch + IPEX via vLLM's XPU requirements, then locks their versions with pip constraints.
80+
- XPU builds install Monarch with `USE_TENSOR_ENGINE=0`, so RDMA and distributed tensor features are disabled for now.
81+
- Optional flag: `--use-sudo` (system packages via `apt`/`dnf` instead of conda).
82+
- Re-activate your conda environment after install to pick up the oneAPI activation hook.
83+
84+
6685
### Pixi
6786

6887
Pixi combines benefits of uv with access to conda forge for system dependencies. [pixi.toml](./pixi.toml) provides a manifest with build tasks with `install` as a the combined install all task.

assets/versions.sh

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,13 @@
99

1010
# Stable versions of upstream libraries for OSS repo
1111
PYTORCH_VERSION="2.9.0"
12-
# ROCm builds vLLM from source (no prebuilt ROCm wheels available)
12+
# ROCm/XPU builds vLLM from source (no prebuilt ROCm/XPU wheels available)
1313
VLLM_ROCM_VERSION="v0.10.0"
14+
VLLM_XPU_VERSION="v0.13.0"
15+
# IPEX wheels shipped with vLLM has hard python version requirement
16+
IPEX_PYTHON_VERSION="3.12"
1417
TORCHSTORE_BRANCH="no-monarch-2026.01.05"
15-
# ROCm install builds these from source (no ROCm wheels); CUDA uses pyproject pins.
18+
# ROCm/XPU builds these from source (no ROCm/XPU wheels); CUDA uses pyproject pins.
1619
TORCHTITAN_VERSION="v0.2.0"
20+
TORCHTITAN_XPU_COMMIT="e61f2cce4fd9c54d314ff0a2dabe035b80a5d49c"
1721
MONARCH_VERSION="v0.2.0"

0 commit comments

Comments
 (0)