[doc] Add a JaxTrainer template#59842
Merged
matthewdeng merged 15 commits intoray-project:masterfrom Feb 2, 2026
Merged
Conversation
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
This pull request introduces a valuable JaxTrainer template for training a GPT-2 style model on GPUs and TPUs. The notebook and markdown file provide a comprehensive walkthrough. My review focuses on improving code correctness, clarity, and maintainability. I've identified a critical bug in the metric reporting logic that could cause training runs to hang, and I've provided a fix. Additionally, I've made several suggestions to enhance the example's robustness and readability, including correcting command-line syntax, simplifying data iteration, and removing redundant code.
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
ray-gardener
bot
added
docs
JasonLi1909
reviewed
Jan 9, 2026
Contributor
JasonLi1909
left a comment
JasonLi1909
left a comment
There was a problem hiding this comment.
Awesome template! Left some comments, reminder to do the other steps (add to ci, compute configs, etc). Would be good to get a pass from @angelinalg at some point. Thanks!
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
JasonLi1909
reviewed
Jan 9, 2026
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
doc/source/train/examples/jax/intro_to_jax_trainer/README.ipynb
Outdated
Show resolved
Hide resolved
matthewdeng
reviewed
Jan 13, 2026
|
This pull request has been automatically marked as stale because it has not had You can always ask for help on our discussion forum or Ray's public slack channel. If you'd like to keep this open, just leave any comment, and the stale label will be removed. |
github-actions
bot
added
the
stale
github-actions
bot
added
unstale
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
matthewdeng
reviewed
Feb 2, 2026
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
Signed-off-by: Lehui Liu <lehui@anyscale.com>
matthewdeng
approved these changes
Feb 2, 2026
rayhhome
pushed a commit
to rayhhome/ray
that referenced
this pull request
Feb 4, 2026
## Description 1. This PR adds a workspace template that walks users through how to Ray Train [JaxTrainer](https://docs.ray.io/en/master/train/api/doc/ray.train.v2.jax.JaxTrainer.html). 2. The purpose of this template is to walk user through how to use the JaxTrainer to train a GPT2 style model with both GPU and TPU. For a high level overview, this template covers: * A hands-on example of training an GPT2 model using Jax/Flax * Sample `ScalingConfig` for both GPU and TPU * Simple integration with Ray Data to read the pre-tokenized openwebtext dataset for training Testing: tested in Anyscale workspace, ## Additional information 1. https://console.anyscale-staging.com/cld_kvedZWag2qA8i5BjxUevf5i7/prj_g7p6lsu6r8g7garwbxifppyz23/workspaces/expwrk_bw8izpdi59293i5e73h6biwkak/train/train/46607266f3cb454aa9e7f7929b3aaae3/workers/fbe9a9b91fdf90e7476bb12a0d000000?workspace-tab=code&command-history-section=application_logs&file=%252Fmnt%252Fcluster_storage%252Fgpt2%252F0104_raydata%252Fcheckpoints%252F1x1&storage=cluster --------- Signed-off-by: Lehui Liu <lehui@anyscale.com> Signed-off-by: Sirui Huang <ray.huang@anyscale.com>
elliot-barn
pushed a commit
that referenced
this pull request
Feb 9, 2026
## Description 1. This PR adds a workspace template that walks users through how to Ray Train [JaxTrainer](https://docs.ray.io/en/master/train/api/doc/ray.train.v2.jax.JaxTrainer.html). 2. The purpose of this template is to walk user through how to use the JaxTrainer to train a GPT2 style model with both GPU and TPU. For a high level overview, this template covers: * A hands-on example of training an GPT2 model using Jax/Flax * Sample `ScalingConfig` for both GPU and TPU * Simple integration with Ray Data to read the pre-tokenized openwebtext dataset for training Testing: tested in Anyscale workspace, ## Additional information 1. https://console.anyscale-staging.com/cld_kvedZWag2qA8i5BjxUevf5i7/prj_g7p6lsu6r8g7garwbxifppyz23/workspaces/expwrk_bw8izpdi59293i5e73h6biwkak/train/train/46607266f3cb454aa9e7f7929b3aaae3/workers/fbe9a9b91fdf90e7476bb12a0d000000?workspace-tab=code&command-history-section=application_logs&file=%252Fmnt%252Fcluster_storage%252Fgpt2%252F0104_raydata%252Fcheckpoints%252F1x1&storage=cluster --------- Signed-off-by: Lehui Liu <lehui@anyscale.com> Signed-off-by: elliot-barn <elliot.barnwell@anyscale.com>
elliot-barn
pushed a commit
that referenced
this pull request
Feb 9, 2026
## Description 1. This PR adds a workspace template that walks users through how to Ray Train [JaxTrainer](https://docs.ray.io/en/master/train/api/doc/ray.train.v2.jax.JaxTrainer.html). 2. The purpose of this template is to walk user through how to use the JaxTrainer to train a GPT2 style model with both GPU and TPU. For a high level overview, this template covers: * A hands-on example of training an GPT2 model using Jax/Flax * Sample `ScalingConfig` for both GPU and TPU * Simple integration with Ray Data to read the pre-tokenized openwebtext dataset for training Testing: tested in Anyscale workspace, ## Additional information 1. https://console.anyscale-staging.com/cld_kvedZWag2qA8i5BjxUevf5i7/prj_g7p6lsu6r8g7garwbxifppyz23/workspaces/expwrk_bw8izpdi59293i5e73h6biwkak/train/train/46607266f3cb454aa9e7f7929b3aaae3/workers/fbe9a9b91fdf90e7476bb12a0d000000?workspace-tab=code&command-history-section=application_logs&file=%252Fmnt%252Fcluster_storage%252Fgpt2%252F0104_raydata%252Fcheckpoints%252F1x1&storage=cluster --------- Signed-off-by: Lehui Liu <lehui@anyscale.com>
ans9868
pushed a commit
to ans9868/ray
that referenced
this pull request
Feb 18, 2026
## Description 1. This PR adds a workspace template that walks users through how to Ray Train [JaxTrainer](https://docs.ray.io/en/master/train/api/doc/ray.train.v2.jax.JaxTrainer.html). 2. The purpose of this template is to walk user through how to use the JaxTrainer to train a GPT2 style model with both GPU and TPU. For a high level overview, this template covers: * A hands-on example of training an GPT2 model using Jax/Flax * Sample `ScalingConfig` for both GPU and TPU * Simple integration with Ray Data to read the pre-tokenized openwebtext dataset for training Testing: tested in Anyscale workspace, ## Additional information 1. https://console.anyscale-staging.com/cld_kvedZWag2qA8i5BjxUevf5i7/prj_g7p6lsu6r8g7garwbxifppyz23/workspaces/expwrk_bw8izpdi59293i5e73h6biwkak/train/train/46607266f3cb454aa9e7f7929b3aaae3/workers/fbe9a9b91fdf90e7476bb12a0d000000?workspace-tab=code&command-history-section=application_logs&file=%252Fmnt%252Fcluster_storage%252Fgpt2%252F0104_raydata%252Fcheckpoints%252F1x1&storage=cluster --------- Signed-off-by: Lehui Liu <lehui@anyscale.com> Signed-off-by: Adel Nour <ans9868@nyu.edu>
peterxcli
pushed a commit
to peterxcli/ray
that referenced
this pull request
Feb 25, 2026
## Description 1. This PR adds a workspace template that walks users through how to Ray Train [JaxTrainer](https://docs.ray.io/en/master/train/api/doc/ray.train.v2.jax.JaxTrainer.html). 2. The purpose of this template is to walk user through how to use the JaxTrainer to train a GPT2 style model with both GPU and TPU. For a high level overview, this template covers: * A hands-on example of training an GPT2 model using Jax/Flax * Sample `ScalingConfig` for both GPU and TPU * Simple integration with Ray Data to read the pre-tokenized openwebtext dataset for training Testing: tested in Anyscale workspace, ## Additional information 1. https://console.anyscale-staging.com/cld_kvedZWag2qA8i5BjxUevf5i7/prj_g7p6lsu6r8g7garwbxifppyz23/workspaces/expwrk_bw8izpdi59293i5e73h6biwkak/train/train/46607266f3cb454aa9e7f7929b3aaae3/workers/fbe9a9b91fdf90e7476bb12a0d000000?workspace-tab=code&command-history-section=application_logs&file=%252Fmnt%252Fcluster_storage%252Fgpt2%252F0104_raydata%252Fcheckpoints%252F1x1&storage=cluster --------- Signed-off-by: Lehui Liu <lehui@anyscale.com> Signed-off-by: peterxcli <peterxcli@gmail.com>
peterxcli
pushed a commit
to peterxcli/ray
that referenced
this pull request
Feb 25, 2026
## Description 1. This PR adds a workspace template that walks users through how to Ray Train [JaxTrainer](https://docs.ray.io/en/master/train/api/doc/ray.train.v2.jax.JaxTrainer.html). 2. The purpose of this template is to walk user through how to use the JaxTrainer to train a GPT2 style model with both GPU and TPU. For a high level overview, this template covers: * A hands-on example of training an GPT2 model using Jax/Flax * Sample `ScalingConfig` for both GPU and TPU * Simple integration with Ray Data to read the pre-tokenized openwebtext dataset for training Testing: tested in Anyscale workspace, ## Additional information 1. https://console.anyscale-staging.com/cld_kvedZWag2qA8i5BjxUevf5i7/prj_g7p6lsu6r8g7garwbxifppyz23/workspaces/expwrk_bw8izpdi59293i5e73h6biwkak/train/train/46607266f3cb454aa9e7f7929b3aaae3/workers/fbe9a9b91fdf90e7476bb12a0d000000?workspace-tab=code&command-history-section=application_logs&file=%252Fmnt%252Fcluster_storage%252Fgpt2%252F0104_raydata%252Fcheckpoints%252F1x1&storage=cluster --------- Signed-off-by: Lehui Liu <lehui@anyscale.com> Signed-off-by: peterxcli <peterxcli@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
For a high level overview, this template covers:
ScalingConfigfor both GPU and TPUTesting:
tested in Anyscale workspace,
Additional information