Skip to content

Conversation

@kashif
Copy link
Collaborator

@kashif kashif commented Nov 1, 2025

What does this PR do?

Added an ALST/Ulysses section to the distributed training doc with yaml config.

Needs: huggingface/accelerate#3817 and huggingface/transformers#41832

Fixes # (issue)

Before submitting

  • This PR fixes a typo or improves the docs (you can dismiss the other checks if that's the case).
  • Did you read the contributor guideline,
    Pull Request section?
  • Was this discussed/approved via a GitHub issue? Please add a link
    to it if that's the case.
  • Did you make sure to update the documentation with your changes?
  • Did you write any new necessary tests?

Who can review?

Anyone in the community is free to review the PR once the tests have passed. Feel free to tag
members/contributors who may be interested in your PR.

- Simplify ALST/Ulysses section to match style of other docs sections
- Condense from ~495 lines to ~164 lines while keeping essential info
- Add practical example using trl/scripts/sft.py with 4 GPUs
- Update requirements to recommend Flash Attention 2 over SDPA
- Add concise 2D parallelism explanation with code snippet
- Simplify best practices to 5 key points
- Streamline troubleshooting section
- Fix alst_ulysses_4gpu.yaml config (remove 'auto' values)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@kashif kashif marked this pull request as draft November 1, 2025 18:41
@HuggingFaceDocBuilderDev

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

kashif and others added 3 commits November 1, 2025 18:43
- Simplify ALST/Ulysses section to match style of other docs sections
- Condense from ~495 lines to ~164 lines while keeping essential info
- Add practical example using trl/scripts/sft.py with 4 GPUs
- Update requirements to recommend Flash Attention 2 over SDPA
- Add concise 2D parallelism explanation with code snippet
- Simplify best practices to 5 key points
- Streamline troubleshooting section
- Fix alst_ulysses_4gpu.yaml config (remove 'auto' values)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

3 participants