Skip to content

docs: mark ROCm as supported and refresh the GB10 benchmark record - #2860

Merged
inureyes merged 2 commits into
mainfrom
update/rocm-official-gb10-benchmarks
Nov 5, 2026
Merged

inureyes merged 2 commits into
mainfrom
update/rocm-official-gb10-benchmarks

Conversation

@inureyes

@inureyes inureyes commented Nov 5, 2026

Copy link
Copy Markdown
Member

Summary

AMD ROCm has been an officially supported backend since 0.8.0, but the user-facing docs still described it as experimental. This updates the support status across the README, installation matrix, architecture overview, environment-variable reference, contributing guide and the ROCm overlay README, and refreshes the benchmark surface for the 0.8.1 GB10 sweep.

Changes

  • Mark Linux and Windows x86_64 ROCm as supported since 0.8. Keep the source-build requirement, the validated configurations and the open gaps unchanged.
  • Rename the installation headings to ## Linux with AMD ROCm and ## Windows with AMD ROCm, and update every anchor link.
  • Add an Unreleased changelog entry. Historical release notes and dated benchmark reports keep their original wording.
  • README performance: add the GB10 0.8.1 version-over-version decode ratios (text median 1.026, VLM median 1.081 with no regressions), the BitNet and DiffusionGemma fixes, and the new embedding, rerank and image generation ladders. GB10 is no longer described as still being on 0.4.0-rc.1.
  • docs/benchmarks.md: point at the GB10 records, correct the cross-host version paragraph, and document scripts/bench_imagegen.py.

Testing

  • Every ROCm anchor resolves to a renamed heading; no current-facing document still calls ROCm experimental.
  • GB10 figures are taken from the committed cuda_gb10_*_2026-11-03 and 2026-11-04 CSVs.
  • Documentation only; no code paths change.

Notes

Prefill is not compared across the two GB10 sweeps because the harness moved to the 512-token synthetic prompt. Only decode is compared.

AMD ROCm has been an officially supported backend since 0.8.0 on Linux and on Windows x86_64, but the README, installation matrix, architecture overview, environment-variable reference and contributing guide still called it experimental. Update the support status and rename the installation headings, so links move from the `-experimental` anchors to #linux-with-amd-rocm and #windows-with-amd-rocm. The validated configurations, the source-build requirement and the open gaps are unchanged.

Add an Unreleased changelog entry for the status change. Historical release notes and dated benchmark reports keep the wording they shipped with.

Refresh the benchmark surface for the 0.8.1 GB10 sweep: the README performance section now records the version-over-version decode ratios, the two fixes that unblocked BitNet and DiffusionGemma, and the first embedding, rerank and image generation ladders on that host. The methodology page points at the GB10 records, says GB10 is current instead of carrying the 0.4.0-rc.1 record, and documents the bench_imagegen.py command. Both pages keep the prefill caveat: the harness changed shape, so only decode is comparable with the older sweep.

Verification: every ROCm anchor resolves to a renamed heading, and no current-facing document still describes ROCm as experimental. The GB10 figures come from the committed 2026-11-03 and 2026-11-04 CSVs.
Windows ROCm is an officially supported backend since 0.8 alongside Linux. The platform matrix, feature table, installation section and overlay README already say so, but the README build-from-source section, the docs index, the architecture overview and the contributing prerequisites still described the platform as Linux-only or left the Windows build undocumented.

Add the Windows ROCm build command and link to the README, list the platform in the docs index, describe the delay-loaded runtime directory in the architecture overview, and add the Windows CUDA and ROCm prerequisites to the contributing guide. Windows NVIDIA CUDA remains experimental, and no code or validation scope changes.
@inureyes
inureyes merged commit f82372d into main Nov 5, 2026
31 checks passed
@inureyes
inureyes deleted the update/rocm-official-gb10-benchmarks branch November 5, 2026 10:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant