nemo-mbridge-perf-expert-parallel-overlap

Enable MoE expert-parallel communication overlap in Megatron-Bridge.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill nemo-mbridge-perf-expert-parallel-overlap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nemo-mbridge-perf-expert-parallel-overlap
Source: https://github.com/sayalinvidia/sayali-skills-test/tree/main/skills/nemo-mbridge-perf-expert-parallel-overlap
Command: npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill nemo-mbridge-perf-expert-parallel-overlap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Overlap expert-parallel token dispatch/collect across multiple GPUs to hide communication costs and improve throughput in Megatron-Bridge MoE workloads.

Core Features & Use Cases

  • Overlaps expert-parallel dispatch/collect with FFN compute to reduce per-step latency.
  • Supports both alltoall and flex dispatchers; applicable to large MoE models requiring throughput tuning.
  • Provides guidance for correctness-first validation and performance evaluation in Megatron-Bridge deployments.

Quick Start

Run the Megatron-Bridge performance setup to enable EP overlap testing on a representative MoE model.

Frequently Asked Questions about nemo-mbridge-perf-expert-parallel-overlap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I overlap expert-parallel token dispatch with compute in Megatron-Bridge MoE?

To overlap expert-parallel token dispatch, enable MoE expert-parallel communication overlap in Megatron-Bridge using either alltoall or flex dispatchers. This hides dispatch and all-to-all communication costs alongside FFN compute to reduce per-step latency.

What are the prerequisites for enabling MoE expert-parallel overlap in distributed training?

Prerequisites for MoE expert-parallel overlap include applying it to models with expert_model_parallel_size > 1, enabling the overlap flag, and setting moe_shared_expert_overlap to False to ensure correct distributed training behavior.

Does Megatron-Bridge EP overlap work with FP32 precision or older PyTorch versions?

Megatron-Bridge EP overlap does not work with FP32 or older PyTorch versions. Compatibility constraints require BF16 or FP16 precision and PyTorch version 2.6.0 or higher for correct MoE overlap functionality.

Can I use delayed wgrad compute with expert-parallel overlap in large MoE models?

You can use delayed wgrad compute with expert-parallel overlap, but it introduces additional Transformer Engine and CUDA-graph considerations. You must account for these specific constraints when configuring large MoE models for throughput tuning.

What is the best way to validate performance after applying expert-parallel overlap in Megatron-Bridge?

The best way to validate performance is running the Megatron-Bridge performance setup for EP overlap testing on a representative MoE model. This provides correctness-first validation and performance evaluation for your specific deployment.