Skip to content

Comments

PR #3204: Migrate MaxText/train_compile.py to maxtext/trainers/pre_train/train_compile.py#3209

Closed
bvandermoon wants to merge 1 commit intomainfrom
test_873125760
Closed

PR #3204: Migrate MaxText/train_compile.py to maxtext/trainers/pre_train/train_compile.py#3209
bvandermoon wants to merge 1 commit intomainfrom
test_873125760

Conversation

@bvandermoon
Copy link
Collaborator

PR #3204: Migrate MaxText/train_compile.py to maxtext/trainers/pre_train/train_compile.py

Imported from GitHub PR #3204

Description

  • Move MaxText/train_compile.py to maxtext/trainers/pre_train/train_compile.py
  • Create shim in MaxText/train.py to support old command. Include a deprecation warning
    • TODO: Add deprecation dates to this and other shims we are adding
  • Next steps: Update existing EXECUTABLE commands to call new path for train/train_compile. Leaving this off for now to keep PR smaller. The old commands still work for these

NOTE: We will fix the ungrouped import lint errors at the end of restructuring. Otherwise we will just be swapping the order of imports repeatedly

Tests

Both new and old commands working as expected.

New command:

python3 -m maxtext.trainers.pre_train.train_compile src/maxtext/configs/base.yml \
    compile_topology=v5e-256 \
    compile_topology_num_slices=2 \
    global_parameter_scale=16 \
    per_device_batch_size=4

Old command:

python3 -m MaxText.train_compile src/maxtext/configs/base.yml \
    compile_topology=v5e-256 \
    compile_topology_num_slices=2 \
    global_parameter_scale=16 \
    per_device_batch_size=4

Checklist

Before submitting this PR, please make sure (put X in square brackets):

  • I have performed a self-review of my code. For an optional AI review, add the gemini-review label.
  • I have necessary comments in my code, particularly in hard-to-understand areas.
  • I have run end-to-end tests tests and provided workload links above if applicable.
  • I have made or will make corresponding changes to the doc if needed, including adding new documentation pages to the relevant Table of Contents (toctree directive) as explained in our documentation.

Copybara import of the project:

--
9dc2704 by Branden Vandermoon bvandermoon@google.com:

Migrate MaxText/train_compile.py to maxtext/trainers/pre_train/train_compile.py

Merging this change closes #3204

FUTURE_COPYBARA_INTEGRATE_REVIEW=#3204 from AI-Hypercomputer:bvandermoon-repo-restructure 9dc2704

…ain/train_compile.py

Imported from GitHub PR #3204

# Description

* Move `MaxText/train_compile.py` to `maxtext/trainers/pre_train/train_compile.py`
* Create shim in MaxText/train.py to support old command. Include a deprecation warning
    * TODO: Add deprecation dates to this and other shims we are adding
* Next steps: Update [existing `EXECUTABLE` commands](https://github.com/AI-Hypercomputer/maxtext/blob/main/src/maxtext/configs/tpu/v4/22b.sh#L58) to call new path for train/train_compile. Leaving this off for now to keep PR smaller. The old commands still work for these

NOTE: We will fix the ungrouped import lint errors at the end of restructuring. Otherwise we will just be swapping the order of imports repeatedly

# Tests

Both new and old commands working as expected.

New command:
```
python3 -m maxtext.trainers.pre_train.train_compile src/maxtext/configs/base.yml \
    compile_topology=v5e-256 \
    compile_topology_num_slices=2 \
    global_parameter_scale=16 \
    per_device_batch_size=4
```

Old command:
```
python3 -m MaxText.train_compile src/maxtext/configs/base.yml \
    compile_topology=v5e-256 \
    compile_topology_num_slices=2 \
    global_parameter_scale=16 \
    per_device_batch_size=4
```

# Checklist

Before submitting this PR, please make sure (put X in square brackets):
- [x] I have performed a self-review of my code. For an optional AI review, add the `gemini-review` label.
- [x] I have necessary comments in my code, particularly in hard-to-understand areas.
- [x] I have run end-to-end tests tests and provided workload links above if applicable.
- [x] I have made or will make corresponding changes to the doc if needed, including adding new documentation pages to the relevant Table of Contents (toctree directive) as explained in [our documentation](https://maxtext.readthedocs.io/en/latest/development.html#adding-new-documentation-files).

Copybara import of the project:

--
9dc2704 by Branden Vandermoon <bvandermoon@google.com>:

Migrate MaxText/train_compile.py to maxtext/trainers/pre_train/train_compile.py

Merging this change closes #3204

FUTURE_COPYBARA_INTEGRATE_REVIEW=#3204 from AI-Hypercomputer:bvandermoon-repo-restructure 9dc2704
PiperOrigin-RevId: 873125760
@bvandermoon
Copy link
Collaborator Author

This PR was used to diff copybara changes only. These changes were merged in #3204

@bvandermoon bvandermoon deleted the test_873125760 branch February 21, 2026 01:00
@codecov
Copy link

codecov bot commented Feb 21, 2026

Codecov Report

❌ Patch coverage is 67.91045% with 43 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
src/maxtext/trainers/pre_train/train_compile.py 76.47% 23 Missing and 5 partials ⚠️
src/MaxText/train_compile.py 0.00% 14 Missing ⚠️
src/MaxText/estimator.py 0.00% 1 Missing ⚠️

📢 Thoughts on this report? Let us know!

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