Release Tracker v3.9.0 - (2025-11-24)

[sa-faizal]

Request description

Overview

[!IMPORTANT] The 3.9.0 release is scheduled for 2025-11-24.

Our previous stable release was published on 2025-10-14: https://github.com/iree-org/iree/releases/tag/v3.8.0. We aim for roughly one stable release every 6 weeks. This issue tracks the release process for the next release.

Release process docs:

• https://iree.dev/developers/general/release-management/
• https://github.com/iree-org/iree/blob/main/RELEASING.md

Release checklist:

• [ ] Watch for major/breaking changes and decide to either batch them with this release or defer them until the next release
• [ ] Choose release candidates from nightly releases to promote. The candidates should contain no major regressions and should include all packages, even those marked experimental in .github/workflows/build_package.yml like macOS and Windows packages.
• [ ] Compile release notes
• [ ] Push IREE packages to PyPI and create a new release on GitHub
• [ ] Push iree-turbine packages to PyPI and create a new release on GitHub
• [ ] Increment version.json files
• [ ] Update release process docs for next time

Testing instructions

(Update this once release candidates are selected. Versions should match within each repository.)

pip install \
  --find-links https://iree.dev/pip-release-links.html \
  iree-base-compiler==3.9.0rc20251125 \
  iree-base-runtime==3.9.0rc20251125 \
  iree-tools-tf==20251125.1456 \
  iree-tools-tflite==20251125.1456 \
  --find-links https://iree.dev/pip-release-links.html \
  iree-turbine==3.9.0rc20251125 \
  --find-links https://github.com/nod-ai/shark-ai/releases/expanded_assets/dev-wheels \

Release notes

Candidate: TBD

Commit range

• Previous release to main: https://github.com/iree-org/iree/compare/v3.8.0...main
• Previous release to release candidate:

(Contributors can edit this section as they land patches)

---

---

Announcements

• Changes to data-tiling flags:
  • iree-opt-data-tiling is an umbrella data-tiling flag with core developer's suggested config. https://github.com/iree-org/iree/pull/22295
  • IREE switches the default to use new data-tiling path, which is equivalent to using iree-dispatch-creation-data-tiling. Users still can start data-tiling either from global optimization phase (the old default) or dispatch creation phase (the new default) based on their needs. See official doc for the comparison and details. To restore the old behavior, users can use iree-global-opt-data-tiling flag. https://github.com/iree-org/iree/pull/21441

Notable changes

Compiler

Runtime

Developer tools

New contributors

(TODO: update this with the autogenerated list)

Full changelog

List of changes

(TODO: update this with the autogenerated notes)

Commit history: https://github.com/iree-org/iree/compare/v3.8.0...v3.9.0

---

---

What component(s) does this issue relate to?

No response

Additional context

No response

What component(s) does this issue relate to?

No response

Additional context

No response

[hanhanW]

I think you now want to pin this issue in Issues, but not https://github.com/iree-org/iree/issues/21868

[hanhanW]

I think you now want to pin this issue in Issues, but not #21868

(I already pinned the issue.)