Skip to content

Mention GPA-AdamW in top-level README#259

Closed
hjmshi wants to merge 4 commits into
facebookresearch:mainfrom
hjmshi:export-D103703525
Closed

Mention GPA-AdamW in top-level README#259
hjmshi wants to merge 4 commits into
facebookresearch:mainfrom
hjmshi:export-D103703525

Conversation

@hjmshi

@hjmshi hjmshi commented May 4, 2026

Copy link
Copy Markdown
Contributor

Summary:
The top-level optimizers/README.md (both internal fbcode/hpc/optimizers/README.md and OSS mirror fbcode/ai_codesign/optimizers/README.md) currently only lists Distributed Shampoo, but the GPA-AdamW optimizer was added under gpa/ and is shipped to the OSS mirror by oss_sync.sh. This adds GPA-AdamW to:

  1. The "Currently includes the optimizers" bullet list.
  2. A new ### GPA-AdamW subsection under Usage with a minimal GPAAdamW(...) instantiation example, plus a pointer to the full gpa/README.md for Schedule-Free vs GPA mode, hyperparameter tuning, and distributed training notes.
  3. A small refactor of the Installation section to drop the distributed_shampoo-specific phrasing and link both example directories.

The two READMEs are kept in sync manually (the OSS sync script does not copy optimizers/README.md), so both files receive identical edits.

Differential Revision: D103703525

hjmshi and others added 4 commits April 29, 2026 15:13
…oad the correct commit data.

Differential Revision: D101275252
…oad the correct commit data.

Differential Revision: D103081868
…oad the correct commit data.

Differential Revision: D103082000
Summary:
The top-level `optimizers/README.md` (both internal `fbcode/hpc/optimizers/README.md` and OSS mirror `fbcode/ai_codesign/optimizers/README.md`) currently only lists Distributed Shampoo, but the GPA-AdamW optimizer was added under `gpa/` and is shipped to the OSS mirror by `oss_sync.sh`. This adds GPA-AdamW to:

1. The "Currently includes the optimizers" bullet list.
2. A new `### GPA-AdamW` subsection under Usage with a minimal `GPAAdamW(...)` instantiation example, plus a pointer to the full `gpa/README.md` for Schedule-Free vs GPA mode, hyperparameter tuning, and distributed training notes.
3. A small refactor of the Installation section to drop the `distributed_shampoo`-specific phrasing and link both example directories.

The two READMEs are kept in sync manually (the OSS sync script does not copy `optimizers/README.md`), so both files receive identical edits.

Differential Revision: D103703525
@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label May 4, 2026
@meta-codesync

meta-codesync Bot commented May 4, 2026

Copy link
Copy Markdown

@hjmshi has exported this pull request. If you are a Meta employee, you can view the originating Diff in D103703525.

@wz337 wz337 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review automatically exported from Phabricator review in Meta.

@meta-codesync

meta-codesync Bot commented May 5, 2026

Copy link
Copy Markdown

This pull request has been merged in 63d910c.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. fb-exported Merged meta-exported

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants