docs: Recommend Reactant for AMD GPU support and add Tenstorrent backend by Copilot · Pull Request #1593 · LuxDL/Lux.jl

Copilot · 2025-12-09T15:04:02Z

Native AMDGPU.jl support is experimental with known deadlocks in distributed training scenarios. This updates documentation to recommend Reactant.jl as the primary path for AMD GPU users.

Changes:

docs/src/index.md: Added warning in GPU installation section directing AMD users to Reactant, clarified GPU backend supports CUDA / ROCM, and added Tenstorrent backend (experimental) tab with set_default_backend("tt")
docs/src/introduction/index.md: Added danger notice and marked AMDGPU.jl as not recommended
docs/src/manual/gpu_management.md: Added AMD-specific guidance to use reactant_device()
docs/src/manual/autodiff.md: Clarified that Reactant + Enzyme supports both NVIDIA and AMD GPUs
docs/src/manual/distributed_utils.md: Updated known limitations to recommend Reactant for AMD distributed training

All AMD-related documentation now consistently steers users toward Reactant for better performance and reliability. Additionally, Reactant backend options now include Tenstorrent support marked as experimental.

Original prompt

This section details on the original issue you should resolve

<issue_title>Update AMD support documentation to recommend using Reactant</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes Update AMD support documentation to recommend using Reactant #1592

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

- Add prominent warnings in index.md recommending Reactant for AMD GPUs - Add danger notice in introduction/index.md for AMD users - Update gpu_management.md with AMD-specific Reactant recommendation - Update autodiff.md to clarify Reactant supports AMD GPUs - Update distributed_utils.md to recommend Reactant for AMD distributed training - Consistently warn about experimental nature of native AMDGPU.jl support Co-authored-by: avik-pal <30564094+avik-pal@users.noreply.github.com>

avik-pal · 2025-12-09T15:16:09Z

@copilot under the docs/src/index.md file with Want Reactant (XLA) Support? add a tab for Tenstorrent (set_gpu_backend("tt")) marking it experimental. additionally in parenthesis under GPU mention CUDA / ROCM

- Add Tenstorrent Backend (Experimental) tab with set_default_backend("tt") - Update GPU Backend tab to specify CUDA / ROCM in parentheses Co-authored-by: avik-pal <30564094+avik-pal@users.noreply.github.com>

Copilot · 2025-12-09T15:21:37Z

@copilot under the docs/src/index.md file with Want Reactant (XLA) Support? add a tab for Tenstorrent (set_gpu_backend("tt")) marking it experimental. additionally in parenthesis under GPU mention...

Done in e070c43. Added Tenstorrent Backend (Experimental) tab with set_default_backend("tt") and updated GPU Backend to specify (CUDA / ROCM).

Changes:

GPU Backend → GPU Backend (CUDA / ROCM)
Added new tab: Tenstorrent Backend (Experimental) with Reactant.set_default_backend("tt")

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

https://api.github.com/repos/JuliaCollections/DataStructures.jl/tarball/4e1fe97fdaed23e9dc21d4d664bea76b65fc50a0
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/JuliaCollections/OrderedCollections.jl/tarball/05868e21324cede2207c6f0f466b4bfef6d5e7ee
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/JuliaLang/Compat.jl/tarball/9d8a54ce4b17aa5bdce0ea5c34bc5e7c340d16ad
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/JuliaLang/PrecompileTools.jl/tarball/07a921781cab75691315adc645096ed5e370cb77
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/JuliaLang/Tokenize.jl/tarball/468b4685af4abe0e9fd4d7bf495a6554a6276e75
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/JuliaPackaging/Preferences.jl/tarball/0f27480397253da18fe2c12a4ba4eb9eb208bf3d
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/KristofferC/Crayons.jl/tarball/249fe38abf76d48563e2f4556bebd215aa317e15
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/MichaelHatherly/CommonMark.jl/tarball/5fdf00d1979fd4883b44b754fc3423175c9504b4
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/domluna/JuliaFormatter.jl/tarball/59cf7ad64f1b0708a4fa4369879d33bad3239b56
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/julia-vscode/CSTParser.jl/tarball/0157e592151e39fa570645e2b2debcdfb8a0f112
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
https://api.github.com/repos/vtjnash/Glob.jl/tarball/97285bbd5230dd766e9ef6749b80fc617126d496
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (http block)
pkg.julialang.org
- Triggering command: /usr/bin/julia julia --startup-file=no -e import Pkg; Pkg.activate(temp=true); Pkg.add(Pkg.PackageSpec(name="JuliaFormatter", version="1")); using JuliaFormatter; format(".") (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Initial plan

418def7

Copilot AI assigned Copilot and avik-pal Dec 9, 2025

Copilot started work on behalf of avik-pal December 9, 2025 15:04 View session

Copilot AI changed the title ~~[WIP] Update AMD support documentation to recommend using Reactant~~ docs: Recommend Reactant for AMD GPU support Dec 9, 2025

Copilot finished work on behalf of avik-pal December 9, 2025 15:14

Copilot AI requested a review from avik-pal December 9, 2025 15:14

Copilot started work on behalf of avik-pal December 9, 2025 15:16 View session

docs: Add Tenstorrent backend support and clarify GPU backends

e070c43

- Add Tenstorrent Backend (Experimental) tab with set_default_backend("tt") - Update GPU Backend tab to specify CUDA / ROCM in parentheses Co-authored-by: avik-pal <30564094+avik-pal@users.noreply.github.com>

Copilot AI changed the title ~~docs: Recommend Reactant for AMD GPU support~~ docs: Recommend Reactant for AMD GPU support and add Tenstorrent backend Dec 9, 2025

Copilot finished work on behalf of avik-pal December 9, 2025 15:23

avik-pal marked this pull request as ready for review December 9, 2025 18:00

avik-pal merged commit 3349e21 into main Dec 9, 2025
14 of 23 checks passed

avik-pal deleted the copilot/update-amd-support-docs branch December 9, 2025 18:00

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: Recommend Reactant for AMD GPU support and add Tenstorrent backend#1593

docs: Recommend Reactant for AMD GPU support and add Tenstorrent backend#1593
avik-pal merged 3 commits intomainfrom
copilot/update-amd-support-docs

Copilot AI commented Dec 9, 2025 •

edited

Loading

Uh oh!

avik-pal commented Dec 9, 2025

Uh oh!

Copilot AI commented Dec 9, 2025 •

edited

Loading

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Copilot AI commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Comments on the Issue (you are @copilot in this section)

Uh oh!

avik-pal commented Dec 9, 2025

Uh oh!

Copilot AI commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Dec 9, 2025 •

edited

Loading

Copilot AI commented Dec 9, 2025 •

edited

Loading