Skip to content

[Main] Numerical fix for FC2 expert bias scales when using use_transformer_engine_op_fuser#5850

Merged
zhongbozhu merged 2 commits into
NVIDIA:mainfrom
zhongbozhu:main_expert_bias_fix
Jul 23, 2026
Merged

[Main] Numerical fix for FC2 expert bias scales when using use_transformer_engine_op_fuser#5850
zhongbozhu merged 2 commits into
NVIDIA:mainfrom
zhongbozhu:main_expert_bias_fix

Conversation

@zhongbozhu

@zhongbozhu zhongbozhu commented Jul 16, 2026

Copy link
Copy Markdown
Contributor
  • I, the PR author, have personally reviewed every line of this PR.

What does this PR do?

Triggered only for use_transformer_engine_op_fuser + routed expert has bias

The fused MoE MLP applies each token’s router probability before FC2:
fc2_input = router_probability * activation(fc1_output)
Previously, FC2 with bias produced:
output = router_probability * (fc2_weight @ activation) + fc2_bias
The correct result is:
output = router_probability * ((fc2_weight @ activation) + fc2_bias)

Numerical unit test

pytest -sv tests/unit_tests/transformer/moe/test_grouped_mlp.py::TestTEGroupedMLP::test_gpu_fused_path_scales_fc2_bias

⚠️ For major changes (either in lines of code or in its impact), please make sure to first share a design doc with the team. If you're unsure what's the best way to do so, contact @NVIDIA/mcore-oncall.

Issue tracking

For PRs from open-source community contributors:

  • New features: a linked issue is required. Please open a feature request and reference it here before submitting the PR.
  • Small updates (bug fixes, minor improvements): a linked issue is recommended and will accelerate the PR review process.

Linked issue:

Contribution process

Pre-checks

  • I have added relevant unit tests
  • I have added relevant functional tests
  • I have added proper typing to my code Typing guidelines
  • I have added relevant documentation
  • I have run the autoformatter.sh on my PR

Code review

Feel free to message or comment @NVIDIA/mcore-oncall to help accelerate your merge into main. The less complex your PR is, the faster it will be approved and merged!

All PRs start as draft. If you open a non-draft PR, it will be automatically converted to draft.

Step 1: Mark PR as "Ready for Review"

  1. When your PR is ready, click Ready for Review.
  2. An oncall reviewer is auto-assigned and expert reviewers are notified based on your changes.
    • Some PRs may jump straight to step 2. This is determined by .github/CODEOWNERS.

⚠️ Only mark as ready once merge-conflicts are resolved and the CI is passing.
Final Review might get declined if these requirements are not fulfilled.

Step 2: Final Review

For PRs that change megatron/core, once all expert reviewers have approved, the Final Review label is applied automatically and final reviewers are assigned.

For PRs outside megatron/core, this step is skipped.

Step 3: Approved

Once all required reviewers have approved, the Approved label is applied automatically.

Merge

Any member of mcore-engineers will be able to merge your PR.

Signed-off-by: zhongboz <zhongboz@nvidia.com>
@zhongbozhu
zhongbozhu requested review from a team as code owners July 16, 2026 19:49
@copy-pr-bot

copy-pr-bot Bot commented Jul 16, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@svcnvidia-nemo-ci
svcnvidia-nemo-ci marked this pull request as draft July 16, 2026 19:49
@github-actions

Copy link
Copy Markdown
Contributor

This PR has been automatically converted to draft because all PRs must start as drafts.

When you are ready for review, click Ready for Review to begin the review process. This will:

  1. Add the oncall reviewer (optional reviewer)
  2. Add required review teams based on your changes

See the contribution guide for more details.

@zhongbozhu
zhongbozhu marked this pull request as ready for review July 16, 2026 19:50
@zhongbozhu

Copy link
Copy Markdown
Contributor Author

/ok to test a1913ae

assert module._is_fused_impl_supported() is True


def test_is_fused_impl_supported_requires_scaled_fc2_bias(monkeypatch):

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.

just a nit; looks like we dont check if fused impl is supported here but not in actual code above? is the current version of TE pinned is well above the min supported version ?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

resolved

Signed-off-by: Zhongbo Zhu <zhongboz@nvidia.com>
@zhongbozhu

Copy link
Copy Markdown
Contributor Author

/ok to test 8ac399d

@svcnvidia-nemo-ci svcnvidia-nemo-ci added the Final Review PR is in the "final review" stage label Jul 22, 2026
@svcnvidia-nemo-ci svcnvidia-nemo-ci added Approved All necessary approvals have been made and removed Final Review PR is in the "final review" stage labels Jul 22, 2026
@zhongbozhu
zhongbozhu added this pull request to the merge queue Jul 22, 2026
@svcnvidia-nemo-ci

Copy link
Copy Markdown
Contributor

🔄 Merge queue validation started!

You can track the progress here: https://github.com/NVIDIA/Megatron-LM/actions/runs/29956320233

@svcnvidia-nemo-ci

Copy link
Copy Markdown
Contributor

🔄 Merge queue validation started!

You can track the progress here: https://github.com/NVIDIA/Megatron-LM/actions/runs/29964343805

@svcnvidia-nemo-ci

Copy link
Copy Markdown
Contributor

🔄 Merge queue validation started!

You can track the progress here: https://github.com/NVIDIA/Megatron-LM/actions/runs/29968255282

Merged via the queue into NVIDIA:main with commit e4ea859 Jul 23, 2026
95 of 97 checks passed
@zhongbozhu
zhongbozhu deleted the main_expert_bias_fix branch July 23, 2026 02:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Approved All necessary approvals have been made complexity: low

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants