Files
derek.holloway 7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
Flatten subprojects into a single base monorepo
2026-09-02 16:34:47 -07:00

2.2 KiB

rock_dev_bootstrap.py — Windows Setup Guide

Prerequisites

Before running the script, ensure you have:

  • Python 3.9+ on PATH
  • CMake < 4.0 (CMake 4 is not yet supported by TheRock on Windows)
  • Ninja on PATH
  • Visual Studio 2022 Build Tools (MSVC 19.42+ / VS 17.12+) with Windows 11 SDK
    • The Windows SDK (Microsoft.VisualStudio.Component.Windows11SDK.22621) must be installed — it provides rc.exe, mt.exe, and system libraries (kernel32.lib, etc.)
    • Run scripts/windows/windows_build_setup.ps1 to install everything via winget
  • Git configured with symlinks and long paths:
    git config --global core.symlinks true
    git config --global core.longpaths true
    
  • Long path support enabled in Windows:
    reg add HKLM\SYSTEM\CurrentControlSet\Control\FileSystem /v LongPathsEnabled /t REG_DWORD /d 1 /f
    
  • GitHub CLI (gh) installed and authenticated (for artifact auto-detection)
  • A TheRock checkout (e.g. D:\develop\claude_workspace\repos\TheRock)

Quick Start

# 1. Bootstrap (auto-detects latest nightly):
python rock_dev_bootstrap.py bootstrap \
    --therock-dir D:/develop/claude_workspace/repos/TheRock \
    --build-dir D:/develop/claude_workspace/build/therock-gfx1151

# 2. Configure components for source build:
python rock_dev_bootstrap.py configure \
    --therock-dir D:/develop/claude_workspace/repos/TheRock \
    --build-dir D:/develop/claude_workspace/build/therock-gfx1151 \
    hipdnn miopenprovider

# 3. Build:
python rock_dev_bootstrap.py build \
    --build-dir D:/develop/claude_workspace/build/therock-gfx1151 \
    -j24

You can also pass a specific run ID to bootstrap if needed:

python rock_dev_bootstrap.py bootstrap --therock-dir /path/to/TheRock 24814526637

Find run IDs at: https://github.com/ROCm/TheRock/actions/workflows/ci_nightly.yml

Iterating on Code Changes

After the initial setup, use the build command for incremental builds:

python rock_dev_bootstrap.py build \
    --build-dir D:/develop/claude_workspace/build/therock-gfx1151 -j24

For a clean rebuild of a component:

python rock_dev_bootstrap.py rebuild \
    --build-dir D:/develop/claude_workspace/build/therock-gfx1151 hipdnn