expert-parallel-overlap

Overlap expert-parallel communication with compute in MoE training.

2.8k|332|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/NVIDIA/skills --skill expert-parallel-overlap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: expert-parallel-overlap
Source: https://github.com/NVIDIA/skills/tree/main/skills/Megatron-Bridge/perf-techniques/expert-parallel-overlap
Command: npx skills add https://github.com/NVIDIA/skills --skill expert-parallel-overlap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Overlap expert-parallel communication with compute in MoE workloads to reduce step time and improve throughput, especially when dispatching tokens across experts.

Core Features & Use Cases

  • Overlap MoE token dispatch and gather with expert compute using both alltoall and flex-based backends.
  • Support for optional delayed wgrad scheduling to further hide communication latency.
  • Works with high-EP configurations and large-scale MoE models to unlock throughput gains in training.

Quick Start

Run a MoE training setup with EP overlap enabled using the alltoall dispatcher to validate performance gains.

Frequently Asked Questions about expert-parallel-overlap

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

FAQPage Schema
How do I overlap expert-parallel communication with compute in MoE training?

To overlap expert-parallel communication with compute in MoE training, you can enable this Skill to reduce training latency by hiding token dispatch and gather operations behind expert compute using alltoall or flex dispatchers.

What are the requirements for overlapping MoE expert-parallel compute?

Overlapping MoE expert-parallel compute requires expert_model_parallel_size > 1, num_moe_experts > 1, moe_token_dispatcher_type set to alltoall or flex, bf16 or fp16 precision, and PyTorch >= 2.6.0.

Does MoE expert-parallel overlap support delayed wgrad and CUDA graphs on Hopper GPUs?

Yes, MoE expert-parallel overlap supports optional delayed wgrad scheduling and CUDA graph interactions to further hide communication latency across Ampere, Hopper, and Blackwell GPU architectures.

Can I use the flex dispatcher for MoE token dispatch overlap in large-scale models?

Yes, you can use the flex dispatcher alongside the alltoall backend for MoE token dispatch overlap, which is specifically designed to unlock throughput gains in large-scale and high-EP MoE workloads.

Why is expert-parallel communication causing latency in my distributed MoE workload?

Expert-parallel communication causes latency in distributed MoE workloads because dispatching tokens across experts creates synchronization bottlenecks that block compute pipelines unless explicitly overlapped.

What is the best way to reduce step time when dispatching tokens across MoE experts?

The best way to reduce step time when dispatching tokens across MoE experts is to overlap the alltoall or flex communication operations with expert compute, optionally scheduling delayed wgrad to maximize throughput.