mxfp4.py 51.8 KB
Newer Older
1
2
# SPDX-License-Identifier: Apache-2.0
# SPDX-FileCopyrightText: Copyright contributors to the vLLM project
3
from enum import Enum
4
5
6
7
8

import torch
from torch.nn.parameter import Parameter

from vllm import envs
9
from vllm._aiter_ops import rocm_aiter_ops
10
from vllm.config import get_current_vllm_config
11
from vllm.logger import init_logger
12
from vllm.model_executor.layers.attention import Attention
13
14
15
16
from vllm.model_executor.layers.fused_moe import (
    FusedMoE,
    FusedMoEConfig,
    FusedMoEMethodBase,
17
    MoEActivation,
18
)
19
from vllm.model_executor.layers.fused_moe import modular_kernel as mk
20
21
22
from vllm.model_executor.layers.fused_moe.all2all_utils import (
    maybe_make_prepare_finalize,
)
23
from vllm.model_executor.layers.fused_moe.config import (
24
    FusedMoEQuantConfig,
25
    mxfp4_mxfp8_moe_quant_config,
26
    mxfp4_w4a16_moe_quant_config,
27
    ocp_mx_moe_quant_config,
28
)
29
from vllm.model_executor.layers.fused_moe.fused_marlin_moe import (
30
    BatchedMarlinExperts,
31
32
    MarlinExperts,
)
33
from vllm.model_executor.layers.fused_moe.gpt_oss_triton_kernels_moe import (
34
    OAITritonExperts,
35
    UnfusedOAITritonExperts,
36
)
37
from vllm.model_executor.layers.fused_moe.trtllm_moe import TrtLlmGenExperts
38
from vllm.model_executor.layers.linear import LinearBase, UnquantizedLinearMethod
39
40
from vllm.model_executor.layers.quantization import QuantizationMethods
from vllm.model_executor.layers.quantization.base_config import (
41
42
43
    QuantizationConfig,
    QuantizeMethodBase,
)
44
45
46
from vllm.model_executor.layers.quantization.utils.marlin_utils import (
    get_marlin_input_dtype,
)
47
from vllm.model_executor.layers.quantization.utils.marlin_utils_fp4 import (
48
49
    prepare_moe_fp4_layer_for_marlin,
)
50
from vllm.model_executor.layers.quantization.utils.mxfp4_utils import (
51
    CK_MXFP4_MOE_DIM_ALIGNMENT,
52
53
    _can_support_mxfp4,
    _swizzle_mxfp4,
54
    get_padding_alignment,
55
56
)
from vllm.model_executor.layers.quantization.utils.quant_utils import is_layer_skipped
57
from vllm.model_executor.utils import set_weight_attrs
58
from vllm.platforms import current_platform
59
from vllm.utils.flashinfer import has_flashinfer
60
from vllm.utils.import_utils import has_triton_kernels
Cyrus Leung's avatar
Cyrus Leung committed
61
from vllm.utils.math_utils import round_up
62

63
64
65
logger = init_logger(__name__)


66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
# enum for mxfp4 backend
class Mxfp4Backend(Enum):
    NONE = 0

    # FlashInfer Backend
    SM100_FI_MXFP4_MXFP8_TRTLLM = 1
    SM100_FI_MXFP4_MXFP8_CUTLASS = 2
    SM100_FI_MXFP4_BF16 = 3
    SM90_FI_MXFP4_BF16 = 4

    # Marlin Backend
    MARLIN = 5

    # Triton Backend
    TRITON = 6

82
83
    CK = 7

84

85
86
87
88
89
90
91
92
def get_mxfp4_backend_with_lora() -> Mxfp4Backend:
    """
    Not all MXFP4 backends support LoRA. Select backends that are known to
    have LoRA support.
    """
    if not current_platform.is_cuda():
        return Mxfp4Backend.NONE

93
94
95
96
97
98
99
100
    # If FlashInfer is not available, try either Marlin or Triton
    triton_kernels_supported = (
        has_triton_kernels()
        # NOTE: triton_kernels are only confirmed to work on SM90 and SM100
        # SM110 fails with this error: https://github.com/vllm-project/vllm/issues/29317
        # SM120 needs this fix: https://github.com/triton-lang/triton/pull/8498
        and (9, 0) <= current_platform.get_device_capability() < (11, 0)
    )
101
102
103
    if envs.VLLM_MXFP4_USE_MARLIN is False and triton_kernels_supported:
        logger.info_once("[get_mxfp4_backend_with_lora] Using Triton backend")
        return Mxfp4Backend.TRITON
104

105
106
    logger.info_once("[get_mxfp4_backend_with_lora] Using Marlin backend")
    return Mxfp4Backend.MARLIN
107
108
109


def get_mxfp4_backend(with_lora_support: bool) -> Mxfp4Backend:
110
    # Backend Selection
111
112
113
114

    if with_lora_support:
        return get_mxfp4_backend_with_lora()

115
    if current_platform.is_cuda():
116
117
118
119
120
        if (
            current_platform.is_device_capability(90)
            and has_flashinfer()
            and envs.VLLM_USE_FLASHINFER_MOE_MXFP4_BF16
        ):
121
122
            logger.info_once("Using FlashInfer MXFP4 BF16 backend for SM90")
            return Mxfp4Backend.SM90_FI_MXFP4_BF16
123
        elif (
124
            current_platform.is_device_capability_family(100)
125
126
127
128
            and has_flashinfer()
            and envs.VLLM_USE_FLASHINFER_MOE_MXFP4_MXFP8_CUTLASS
        ):
            logger.info_once("Using FlashInfer MXFP4 MXFP8 CUTLASS backend for SM100")
129
            return Mxfp4Backend.SM100_FI_MXFP4_MXFP8_CUTLASS
130
        elif (
131
            current_platform.is_device_capability_family(100)
132
133
134
            and has_flashinfer()
            and envs.VLLM_USE_FLASHINFER_MOE_MXFP4_MXFP8
        ):
135
136
137
            logger.info_once(
                "Using FlashInfer MXFP4 MXFP8 TRTLLM backend for SM100", scope="local"
            )
138
            return Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM
139
        elif current_platform.is_device_capability_family(100) and has_flashinfer():
140
141
142
143
            logger.info_once(
                "Using FlashInfer MXFP4 BF16 backend for SM100, "
                "For faster performance on SM100, consider setting "
                "VLLM_USE_FLASHINFER_MOE_MXFP4_MXFP8=1, though this may impact "
144
145
                "accuracy."
            )
146
            return Mxfp4Backend.SM100_FI_MXFP4_BF16
147
        elif (
148
            current_platform.is_device_capability_family(100)
149
150
            or current_platform.is_device_capability(90)
        ) and not has_flashinfer():
151
152
153
            logger.warning_once(
                "MXFP4 MoE is enabled on Hopper/Blackwell but FlashInfer "
                "is not available. This may result in degraded performance. "
154
155
                "Please `pip install vllm[flashinfer]` for best results."
            )
156

157
        # If FlashInfer is not available, try either Marlin or Triton
158
159
160
161
162
163
164
165
        triton_kernels_supported = (
            has_triton_kernels()
            # NOTE: triton_kernels are only confirmed to work on SM90 and SM100
            # SM110 fails with this error: https://github.com/vllm-project/vllm/issues/29317
            # SM120 needs this fix: https://github.com/triton-lang/triton/pull/8498
            and (9, 0) <= current_platform.get_device_capability() < (11, 0)
        )
        if envs.VLLM_MXFP4_USE_MARLIN or not triton_kernels_supported:
166
167
168
169
170
            logger.info_once("Using Marlin backend")
            return Mxfp4Backend.MARLIN
        else:
            logger.info_once("Using Triton backend")
            return Mxfp4Backend.TRITON
171
    elif current_platform.is_xpu():
172
        logger.info_once("Using xpu backend on XPU")
173
        return Mxfp4Backend.MARLIN
174
175
176
177
178
179
180
181
182
    elif current_platform.is_rocm():
        from vllm.platforms.rocm import on_gfx950

        if rocm_aiter_ops.is_enabled() and on_gfx950():
            logger.info_once("Using CK MXFP4 MoE backend (Aiter ROCm)")
            return Mxfp4Backend.CK
        elif has_triton_kernels():
            logger.info_once("Using Triton backend")
            return Mxfp4Backend.TRITON
183

184
    return Mxfp4Backend.NONE
185
186
187


class Mxfp4Config(QuantizationConfig):
188
    def __init__(self, ignored_layers: list[str] | None = None):
189
190
191
192
193
194
195
196
197
        super().__init__()
        self.ignored_layers = ignored_layers

    @classmethod
    def from_config(cls, config):
        return cls()

    @classmethod
    def get_min_capability(cls) -> int:
198
        return 80
199
200
201
202
203
204
205
206
207
208
209
210
211

    @classmethod
    def get_name(cls) -> QuantizationMethods:
        return "mxfp4"

    @classmethod
    def get_supported_act_dtypes(cls) -> list[torch.dtype]:
        return [torch.bfloat16]

    @classmethod
    def get_config_filenames(cls) -> list[str]:
        return []

212
213
    def get_quant_method(
        self, layer: torch.nn.Module, prefix: str
214
    ) -> "QuantizeMethodBase | None":
215
216
        if isinstance(layer, LinearBase):
            if self.ignored_layers and is_layer_skipped(
217
218
219
220
                prefix=prefix,
                ignored_layers=self.ignored_layers,
                fused_mapping=self.packed_modules_mapping,
            ):
221
                return UnquantizedLinearMethod()
222
223
224
            # TODO: Add support for MXFP4 Linear Method.
            # MXFP4 LinearMethod is available in AMD-Quark, refer to that implementation
            # if you are interested in enabling MXFP4 here.
225
            logger.debug_once(
226
                "MXFP4 linear layer is not implemented - falling back to "
227
228
                "UnquantizedLinearMethod.",
                scope="local",
229
230
            )
            return UnquantizedLinearMethod()
231
        elif isinstance(layer, FusedMoE):
232
            if current_platform.is_xpu():
233
                return XpuMxfp4MoEMethod(layer.moe_config)
234
            else:
235
236
                quant_method = Mxfp4MoEMethod(layer.moe_config)
                return quant_method
237
        elif isinstance(layer, Attention):
238
            # TODO: Add support for MXFP4 Attention.
239
            logger.debug_once(
240
                "MXFP4 attention layer is not implemented. "
241
242
                "Skipping quantization for this layer.",
                scope="local",
243
            )
244
245
        return None

246
247
248
249
    def is_mxfp4_quant(self, prefix: str, layer: torch.nn.Module) -> bool:
        """MXFP4 config always uses MXFP4 quantization."""
        return True

250
251

class Mxfp4MoEMethod(FusedMoEMethodBase):
252
253
    """MXFP4 MoE quantization method."""

254
    def __init__(self, moe: FusedMoEConfig):
255
        super().__init__(moe)
256
        self.weight_dtype = "mxfp4"
257
        self.mxfp4_backend = get_mxfp4_backend(moe.is_lora_enabled)
258

259
        self.max_capture_size = (
260
            get_current_vllm_config().compilation_config.max_cudagraph_capture_size
261
        )
262

263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
        # CK's pre-compiled MXFP4 MoE GEMM kernel instances have dimension
        # alignment requirements. Fall back to Triton when not met.
        if (
            self.mxfp4_backend == Mxfp4Backend.CK
            and moe.intermediate_size_per_partition % CK_MXFP4_MOE_DIM_ALIGNMENT != 0
        ):
            if has_triton_kernels():
                logger.warning_once(
                    "CK MXFP4 MoE GEMM does not support "
                    "intermediate_size_per_partition=%d (not a multiple of "
                    "%d). Falling back to Triton backend.",
                    moe.intermediate_size_per_partition,
                    CK_MXFP4_MOE_DIM_ALIGNMENT,
                )
                self.mxfp4_backend = Mxfp4Backend.TRITON
            else:
                raise ValueError(
                    f"CK MXFP4 MoE GEMM does not support "
                    f"intermediate_size_per_partition="
                    f"{moe.intermediate_size_per_partition} (not a multiple "
                    f"of {CK_MXFP4_MOE_DIM_ALIGNMENT}) and no Triton "
                    f"fallback is available. Use a compatible "
                    f"tensor_parallel_size."
                )

288
        assert self.mxfp4_backend != Mxfp4Backend.NONE, (
289
290
            f"get_mxfp4_backend(with_lora_support={moe.is_lora_enabled}) found"
            "no compatible MXFP4 MoE backend (FlashInfer/Marlin/Triton)."
291
292
            "Please check your environment and try again."
        )
293
        self._cache_permute_indices: dict[torch.Size, torch.Tensor] = {}
294
        # Initialized in process_weights_after_loading for CUTLASS/SM90 backends
295
        self.moe_kernel: mk.FusedMoEKernel | None = None
296

297
298
299
300
301
302
    @property
    def skip_forward_padding(self) -> bool:
        # SM100_FI_MXFP4_MXFP8_TRTLLM supports padding with mxfp8 quant
        # so can skip the padding in the forward before applying the moe method
        return self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM

303
304
305
306
307
308
309
310
311
    def create_weights(
        self,
        layer: torch.nn.Module,
        num_experts: int,
        hidden_size: int,
        intermediate_size_per_partition: int,
        params_dtype: torch.dtype,
        **extra_weight_attrs,
    ):
312
313
314
315
316
317
318
319
320
321
322
323
324
325
        self.num_experts = num_experts
        weight_dtype = torch.uint8
        scale_dtype = torch.uint8

        # FIXME (zyongye): ship after torch and safetensors support mxfp4
        # is_torch_mxfp4_available = (
        #     hasattr(torch, "float4_e2m1fn_x2") and
        #     hasattr(torch, "float8_e8m0fnu"))
        # if is_torch_mxfp4_available:
        #     weight_dtype = torch.float4_e2m1fn_x2
        #     scale_dtype = torch.float8_e8m0fnu

        mxfp4_block = 32

326
        intermediate_size_per_partition_after_pad = intermediate_size_per_partition
327
        if self.mxfp4_backend == Mxfp4Backend.MARLIN:
328
329
330
331
332
333
334
335
336
            # The moe marlin kernel requires that for each linear
            # n % 256 == 0 and k % 128 == 0.
            # In gate_up_proj:
            #    n = 2 * intermediate_size_per_partition_after_pad
            #    k = hidden_size
            # In down_proj
            #    n = hidden_size
            #    k = intermediate_size_per_partition_after_pad
            intermediate_size_per_partition_after_pad = round_up(
337
338
                intermediate_size_per_partition, 128
            )
339
340
341
342
            if current_platform.is_xpu():
                hidden_size = round_up(hidden_size, 128)
            else:
                hidden_size = round_up(hidden_size, 256)
343
344
345
346

            layer.params_dtype = params_dtype
            layer.num_experts = num_experts
            layer.hidden_size = hidden_size
347
            layer.intermediate_size_per_partition = (
348
                intermediate_size_per_partition_after_pad
349
350
351
352
353
            )
        elif (
            self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM
            or self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_BF16
        ):
354
355
356
            # pad the intermediate size to be a multiple of 2 * mxfp4_block
            # for to hold non-uniform sharded tensor as well as swizzling
            # other padding to increase performance
357
            intermediate_size_per_partition_after_pad = round_up(
358
359
                intermediate_size_per_partition, 256
            )
360
            hidden_size = round_up(hidden_size, 256)
361
362
363
364
        elif (
            self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_CUTLASS
            or self.mxfp4_backend == Mxfp4Backend.SM90_FI_MXFP4_BF16
        ):
365
            intermediate_size_per_partition_after_pad = round_up(
366
367
                intermediate_size_per_partition, 128
            )
368
            hidden_size = round_up(hidden_size, 128)
369
        elif current_platform.is_rocm():
370
            pad_align = get_padding_alignment()
371
            intermediate_size_per_partition_after_pad = round_up(
372
                intermediate_size_per_partition, pad_align
373
            )
374
            hidden_size = round_up(hidden_size, pad_align)
375
376
        else:
            intermediate_size_per_partition_after_pad = round_up(
377
378
                intermediate_size_per_partition, 64
            )
379
380
381

        self.intermediate_size = intermediate_size_per_partition_after_pad
        self.hidden_size = hidden_size
382
383
384
385
        self.hidden_pad = extra_weight_attrs.get("hidden_pad", 0)
        self.intermediate_pad = (
            intermediate_size_per_partition_after_pad - intermediate_size_per_partition
        )
386
        # Fused gate_up_proj (column parallel)
387
388
389
390
391
392
393
394
395
        w13_weight = torch.nn.Parameter(
            torch.zeros(
                num_experts,
                2 * intermediate_size_per_partition_after_pad,
                hidden_size // 2,
                dtype=weight_dtype,
            ),
            requires_grad=False,
        )
396
397
398
        layer.register_parameter("w13_weight", w13_weight)
        set_weight_attrs(w13_weight, extra_weight_attrs)

399
400
401
402
403
404
405
406
407
        w13_weight_scale = torch.nn.Parameter(
            torch.zeros(
                num_experts,
                2 * intermediate_size_per_partition_after_pad,
                hidden_size // mxfp4_block,
                dtype=scale_dtype,
            ),
            requires_grad=False,
        )
408
409
410
        layer.register_parameter("w13_weight_scale", w13_weight_scale)
        set_weight_attrs(w13_weight_scale, extra_weight_attrs)

411
412
413
414
415
416
417
418
        w13_bias = torch.nn.Parameter(
            torch.zeros(
                num_experts,
                2 * intermediate_size_per_partition_after_pad,
                dtype=torch.bfloat16,
            ),
            requires_grad=False,
        )
419
420
421
422
        layer.register_parameter("w13_bias", w13_bias)
        set_weight_attrs(w13_bias, extra_weight_attrs)

        # down_proj (row parallel)
423
424
425
426
427
428
429
430
431
        w2_weight = torch.nn.Parameter(
            torch.zeros(
                num_experts,
                hidden_size,
                intermediate_size_per_partition_after_pad // 2,
                dtype=weight_dtype,
            ),
            requires_grad=False,
        )
432
433
434
        layer.register_parameter("w2_weight", w2_weight)
        set_weight_attrs(w2_weight, extra_weight_attrs)

435
436
437
438
439
440
441
442
443
        w2_weight_scale = torch.nn.Parameter(
            torch.zeros(
                num_experts,
                hidden_size,
                intermediate_size_per_partition_after_pad // mxfp4_block,
                dtype=scale_dtype,
            ),
            requires_grad=False,
        )
444
445
446
        layer.register_parameter("w2_weight_scale", w2_weight_scale)
        set_weight_attrs(w2_weight_scale, extra_weight_attrs)

447
448
449
450
451
452
453
454
        w2_bias = torch.nn.Parameter(
            torch.zeros(
                num_experts,
                hidden_size,
                dtype=torch.bfloat16,
            ),
            requires_grad=False,
        )
455
456
457
458
        layer.register_parameter("w2_bias", w2_bias)
        set_weight_attrs(w2_bias, extra_weight_attrs)

    def process_weights_after_loading(self, layer):
459
        if self.mxfp4_backend == Mxfp4Backend.MARLIN:
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
            prepare_moe_fp4_layer_for_marlin(
                layer, input_dtype=get_marlin_input_dtype()
            )

            self.moe_quant_config = self.get_fused_moe_quant_config(layer)
            assert self.moe_quant_config is not None

            prepare_finalize = maybe_make_prepare_finalize(
                moe=self.moe,
                quant_config=self.moe_quant_config,
                routing_tables=layer._maybe_init_expert_routing_tables(),
                allow_new_interface=True,
            )
            assert prepare_finalize is not None

475
            self.moe_kernel = mk.FusedMoEKernel(
476
477
478
479
480
481
482
483
                prepare_finalize,
                MarlinExperts(
                    self.moe,
                    self.moe_quant_config,
                ),
                inplace=not self.moe.disable_inplace,
                shared_experts=None,
            )
484
485
486
487
488
        elif (
            self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM
            or self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_BF16
        ):
            from flashinfer.fp4_quantization import nvfp4_block_scale_interleave
489
            from flashinfer.fused_moe.core import get_w2_permute_indices_with_cache
490
491
492
493
494
495
496
497
498
499
500
501
502

            layer.gemm1_alpha = Parameter(
                torch.tensor([1.702] * self.num_experts, dtype=torch.float32).cuda(),
                requires_grad=False,
            )
            layer.gemm1_beta = Parameter(
                torch.tensor([1.0] * self.num_experts, dtype=torch.float32).cuda(),
                requires_grad=False,
            )
            layer.gemm1_clamp_limit = Parameter(
                torch.tensor([7.0] * self.num_experts, dtype=torch.float32).cuda(),
                requires_grad=False,
            )
503
504
            sf_block_size = 32  # mxfp4 block size

505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
            assert (
                layer.w13_weight.dim() == 3
                and layer.w13_weight.shape[0] == self.num_experts
                and layer.w13_weight.shape[1] == self.intermediate_size * 2
                and layer.w13_weight.shape[2] == self.hidden_size // 2
            )
            assert (
                layer.w13_weight_scale.dim() == 3
                and layer.w13_weight_scale.shape[0] == self.num_experts
                and layer.w13_weight_scale.shape[1] == self.intermediate_size * 2
                and layer.w13_weight_scale.shape[2] == self.hidden_size // sf_block_size
            )
            assert (
                layer.w2_weight.dim() == 3
                and layer.w2_weight.shape[0] == self.num_experts
                and layer.w2_weight.shape[1] == self.hidden_size
                and layer.w2_weight.shape[2] == self.intermediate_size // 2
            )
            assert (
                layer.w2_weight_scale.dim() == 3
                and layer.w2_weight_scale.shape[1] == self.hidden_size
                and layer.w2_weight_scale.shape[2]
                == self.intermediate_size // sf_block_size
            )
            assert (
                layer.w13_bias.dim() == 2
                and layer.w13_bias.shape[0] == self.num_experts
                and layer.w13_bias.shape[1] == self.intermediate_size * 2
            )
            assert (
                layer.w2_bias.dim() == 2
                and layer.w2_bias.shape[0] == self.num_experts
                and layer.w2_bias.shape[1] == self.hidden_size
            )
539
540
541
542
543
544
545
546

            w13_weight_scale = layer.w13_weight_scale.data
            w2_weight_scale = layer.w2_weight_scale.data
            w13_weight = layer.w13_weight.data
            w2_weight = layer.w2_weight.data
            w13_bias = layer.w13_bias.data.to(torch.float32)
            w2_bias = layer.w2_bias.data.to(torch.float32)

co63oc's avatar
co63oc committed
547
            # Swap w1 and w3 as the definition of
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
            # swiglu is different in the trtllm-gen
            def swap_every_two_rows(x, axis=-1):
                shape = x.shape
                if axis < 0:
                    axis = len(shape) + axis

                # Create a new shape with pairs swapped along specified axis
                new_shape = list(shape)
                new_shape[axis] = shape[axis] // 2
                new_shape.insert(axis + 1, 2)

                # Reshape to expose pairs, swap them, and reshape back
                x = x.reshape(*new_shape)
                x = x.flip(axis + 1)
                new_shape = list(shape)
                return x.reshape(*new_shape)

            w13_weight_scale = swap_every_two_rows(w13_weight_scale, -2)
            w13_weight = swap_every_two_rows(w13_weight, -2)
            w13_bias = swap_every_two_rows(w13_bias, -1)

            # Do not interleave as the checkpoint is already interleaved

            # Shuffle weights and scaling factors for transposed mma output
            gemm1_weights_mxfp4_shuffled = []
            gemm1_scales_mxfp4_shuffled = []
            gemm2_weights_mxfp4_shuffled = []
            gemm2_scales_mxfp4_shuffled = []
            gemm1_bias_shuffled = []
            gemm2_bias_shuffled = []
            epilogue_tile_m = 128  # FIXME: this depends on the kernel internals
            for i in range(self.num_experts):
580
                # w13 weight shuffling
581
                permute_indices = get_w2_permute_indices_with_cache(
582
583
584
585
                    self._cache_permute_indices,
                    w13_weight[i].view(torch.uint8),
                    epilogue_tile_m,
                )
586
587
588
589
590
                gemm1_weights_mxfp4_shuffled.append(
                    w13_weight[i]
                    .view(torch.uint8)[permute_indices.to(w13_weight.device)]
                    .contiguous()
                )
591
                # w13 scale shuffling
592
                permute_sf_indices = get_w2_permute_indices_with_cache(
593
594
595
596
597
                    self._cache_permute_indices,
                    w13_weight_scale[i].view(torch.uint8),
                    epilogue_tile_m,
                    num_elts_per_sf=16,
                )
598
                gemm1_scales_mxfp4_shuffled.append(
599
600
601
602
603
604
605
606
                    nvfp4_block_scale_interleave(
                        w13_weight_scale[i]
                        .view(torch.uint8)[
                            permute_sf_indices.to(w13_weight_scale.device)
                        ]
                        .contiguous()
                    )
                )
607
                # w13 bias shuffling
608
                permute_bias_indices = get_w2_permute_indices_with_cache(
609
610
611
612
                    self._cache_permute_indices,
                    w13_bias[i].clone().reshape(-1, 1),
                    epilogue_tile_m,
                )
613
614
615
616
617
618
                gemm1_bias_shuffled.append(
                    w13_bias[i]
                    .clone()
                    .reshape(-1, 1)[permute_bias_indices.to(w13_bias.device)]
                    .contiguous()
                )
619
                # w2 weight shuffling
620
                permute_indices = get_w2_permute_indices_with_cache(
621
622
623
624
                    self._cache_permute_indices,
                    w2_weight[i].view(torch.uint8),
                    epilogue_tile_m,
                )
625
626
627
628
629
                gemm2_weights_mxfp4_shuffled.append(
                    w2_weight[i]
                    .view(torch.uint8)[permute_indices.to(w2_weight.device)]
                    .contiguous()
                )
630
                # w2 scale shuffling
631
                permute_sf_indices = get_w2_permute_indices_with_cache(
632
633
634
635
636
                    self._cache_permute_indices,
                    w2_weight_scale[i].view(torch.uint8),
                    epilogue_tile_m,
                    num_elts_per_sf=16,
                )
637
                gemm2_scales_mxfp4_shuffled.append(
638
639
640
641
642
643
644
645
                    nvfp4_block_scale_interleave(
                        w2_weight_scale[i]
                        .view(torch.uint8)[
                            permute_sf_indices.to(w2_weight_scale.device)
                        ]
                        .contiguous()
                    )
                )
646
                # w2 bias shuffling
647
                permute_indices = get_w2_permute_indices_with_cache(
648
649
650
651
                    self._cache_permute_indices,
                    w2_bias[i].clone().reshape(-1, 1),
                    epilogue_tile_m,
                )
652
653
654
655
656
657
                gemm2_bias_shuffled.append(
                    w2_bias[i]
                    .clone()
                    .reshape(-1, 1)[permute_indices.to(w2_bias.device)]
                    .contiguous()
                )
658
659

            w13_weight = torch.stack(gemm1_weights_mxfp4_shuffled)
660
661
662
663
664
665
666
667
668
            w13_weight_scale = (
                torch.stack(gemm1_scales_mxfp4_shuffled)
                .reshape(
                    self.num_experts,
                    2 * self.intermediate_size,
                    self.hidden_size // sf_block_size,
                )
                .view(torch.float8_e4m3fn)
            )
669
670

            w2_weight = torch.stack(gemm2_weights_mxfp4_shuffled)
671
672
673
674
675
676
677
678
679
            w2_weight_scale = (
                torch.stack(gemm2_scales_mxfp4_shuffled)
                .reshape(
                    self.num_experts,
                    self.hidden_size,
                    self.intermediate_size // sf_block_size,
                )
                .view(torch.float8_e4m3fn)
            )
680
681

            layer.w13_weight = Parameter(w13_weight, requires_grad=False)
682
            layer.w13_weight_scale = Parameter(w13_weight_scale, requires_grad=False)
683
            layer.w2_weight = Parameter(w2_weight, requires_grad=False)
684
            layer.w2_weight_scale = Parameter(w2_weight_scale, requires_grad=False)
685
686
            layer.w13_bias = Parameter(
                torch.stack(gemm1_bias_shuffled).reshape(self.num_experts, -1),
687
688
689
690
691
692
693
694
695
696
                requires_grad=False,
            )
            layer.w2_bias = Parameter(
                torch.stack(gemm2_bias_shuffled).reshape(self.num_experts, -1),
                requires_grad=False,
            )
        elif (
            self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_CUTLASS
            or self.mxfp4_backend == Mxfp4Backend.SM90_FI_MXFP4_BF16
        ):
697
698
699
            sf_block_size = 32  # mxfp4 block size

            # Common shape assertions
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
            assert (
                layer.w13_weight.dim() == 3
                and layer.w13_weight.shape[0] == self.num_experts
                and layer.w13_weight.shape[1] == self.intermediate_size * 2
                and layer.w13_weight.shape[2] == self.hidden_size // 2
            )
            assert (
                layer.w13_weight_scale.dim() == 3
                and layer.w13_weight_scale.shape[0] == self.num_experts
                and layer.w13_weight_scale.shape[1] == self.intermediate_size * 2
                and layer.w13_weight_scale.shape[2] == self.hidden_size // sf_block_size
            )
            assert (
                layer.w2_weight.dim() == 3
                and layer.w2_weight.shape[0] == self.num_experts
                and layer.w2_weight.shape[1] == self.hidden_size
                and layer.w2_weight.shape[2] == self.intermediate_size // 2
            )
            assert (
                layer.w2_weight_scale.dim() == 3
                and layer.w2_weight_scale.shape[1] == self.hidden_size
                and layer.w2_weight_scale.shape[2]
                == self.intermediate_size // sf_block_size
            )
            assert (
                layer.w13_bias.dim() == 2
                and layer.w13_bias.shape[0] == self.num_experts
                and layer.w13_bias.shape[1] == self.intermediate_size * 2
            )
            assert (
                layer.w2_bias.dim() == 2
                and layer.w2_bias.shape[0] == self.num_experts
                and layer.w2_bias.shape[1] == self.hidden_size
            )
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758

            # De-interleave and swap for w13 weight, bias, and scales
            w13_w = layer.w13_weight.data
            gate_w, up_w = w13_w[:, ::2, :], w13_w[:, 1::2, :]
            deinterleaved_w13_w = torch.cat([gate_w, up_w], dim=1)
            w1_w, w3_w = torch.chunk(deinterleaved_w13_w, 2, dim=1)
            w13_weight_swapped = torch.cat([w3_w, w1_w], dim=1)

            w13_b = layer.w13_bias.data.to(torch.float32)
            gate_b, up_b = w13_b[:, ::2], w13_b[:, 1::2]
            deinterleaved_w13_b = torch.cat([gate_b, up_b], dim=1)
            b1, b3 = torch.chunk(deinterleaved_w13_b, 2, dim=-1)
            w13_bias_swapped = torch.cat([b3, b1], dim=-1).to(torch.bfloat16)

            w13_s = layer.w13_weight_scale.data
            gate_s, up_s = w13_s[:, ::2, :], w13_s[:, 1::2, :]
            deinterleaved_w13_s = torch.cat([gate_s, up_s], dim=1)
            s1, s3 = torch.chunk(deinterleaved_w13_s, 2, dim=1)
            w13_scale_swapped = torch.cat([s3, s1], dim=1)

            if self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_CUTLASS:
                from flashinfer import block_scale_interleave

                orig_shape = w13_scale_swapped.shape
                w13_scale_interleaved = block_scale_interleave(
759
760
                    w13_scale_swapped.view(torch.uint8)
                ).reshape(orig_shape)
761
762
763
764

                w2_s = layer.w2_weight_scale.data
                orig_shape = w2_s.shape
                w2_scale_interleaved = block_scale_interleave(
765
766
767
768
769
770
771
772
773
774
775
                    w2_s.view(torch.uint8)
                ).reshape(orig_shape)

                layer.w13_weight = Parameter(w13_weight_swapped, requires_grad=False)
                layer.w13_weight_scale = Parameter(
                    w13_scale_interleaved, requires_grad=False
                )
                layer.w13_bias = Parameter(w13_bias_swapped, requires_grad=False)
                layer.w2_weight_scale = Parameter(
                    w2_scale_interleaved, requires_grad=False
                )
776
777
778
779
            elif self.mxfp4_backend == Mxfp4Backend.SM90_FI_MXFP4_BF16:

                def _interleave_mxfp4_cutlass_sm90(w):
                    w_shape = w.shape
780
781
782
                    w_interleaved = w.reshape(
                        w_shape[0], w_shape[1], (w_shape[2] // 4), 4
                    )
783
784
                    w_interleaved = w_interleaved.permute(0, 2, 1, 3)
                    w_interleaved = w_interleaved.reshape(
785
786
                        w_shape[0], w_shape[2] // 4, w_shape[1] * 4
                    )
787
788
                    return w_interleaved

789
790
                w31_scales = w13_scale_swapped.to(torch.uint8).view(torch.uint8)
                w31_scales_interleaved = _interleave_mxfp4_cutlass_sm90(w31_scales)
791
792
793

                w2_weight_scale = layer.w2_weight_scale.data
                w2_scales = w2_weight_scale.to(torch.uint8).view(torch.uint8)
794
795
796
797
798
799
800
801
                w2_scales_interleaved = _interleave_mxfp4_cutlass_sm90(w2_scales)

                layer.w13_weight = torch.nn.Parameter(
                    torch.cat([w3_w, w1_w], dim=1), requires_grad=False
                )
                layer.w13_bias = torch.nn.Parameter(
                    w13_bias_swapped, requires_grad=False
                )
802
                layer.w13_weight_scale = torch.nn.Parameter(
803
804
                    w31_scales_interleaved, requires_grad=False
                )
805
                layer.w2_weight_scale = torch.nn.Parameter(
806
807
                    w2_scales_interleaved, requires_grad=False
                )
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823

            # theses two kernels go through the `flashinfer_cutlass_fused_moe` path
            from vllm.model_executor.layers.fused_moe.flashinfer_cutlass_moe import (
                FlashInferExperts,
            )

            self.moe_quant_config = self.get_fused_moe_quant_config(layer)
            assert self.moe_quant_config is not None
            prepare_finalize = maybe_make_prepare_finalize(
                moe=self.moe,
                quant_config=self.moe_quant_config,
                routing_tables=layer._maybe_init_expert_routing_tables(),
                allow_new_interface=True,
            )
            assert prepare_finalize is not None

824
            self.moe_kernel = mk.FusedMoEKernel(
825
826
827
828
829
830
831
                prepare_finalize,
                FlashInferExperts(
                    moe_config=self.moe,
                    quant_config=self.moe_quant_config,
                ),
                shared_experts=None,
            )
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
        elif self.mxfp4_backend == Mxfp4Backend.CK:
            if layer.w13_bias is not None:
                layer.w13_bias.data = layer.w13_bias.data.to(torch.float32)
            if layer.w2_bias.data is not None:
                layer.w2_bias.data = layer.w2_bias.data.to(torch.float32)

            e, n, k = layer.w13_weight.shape
            layer.w13_weight.view(torch.uint8).copy_(
                layer.w13_weight.data.view(torch.uint8)
                .view(e, n // 2, 2, k)
                .permute(0, 2, 1, 3)
                .contiguous()
                .view(e, n, k)
            )
            layer.w13_weight_scale.data = (
                layer.w13_weight_scale.data.view(e, n // 2, 2, -1)
                .permute(0, 2, 1, 3)
                .contiguous()
                .view(e, n, -1)
            )
            layer.w13_weight.data = layer.w13_weight.data.view(torch.float4_e2m1fn_x2)
            layer.w2_weight.data = layer.w2_weight.data.view(torch.float4_e2m1fn_x2)

            layer.w13_weight.data = rocm_aiter_ops.shuffle_weight_a16w4(
                layer.w13_weight, 16, True
            )
            shuffled_w13_scale = rocm_aiter_ops.shuffle_scale_a16w4(
                layer.w13_weight_scale.view(-1, layer.w13_weight_scale.shape[-1]),
                self.num_experts,
                True,
            )

            layer.w2_weight.data = rocm_aiter_ops.shuffle_weight_a16w4(
                layer.w2_weight, 16, False
            )
            shuffled_w2_scale = rocm_aiter_ops.shuffle_scale_a16w4(
                layer.w2_weight_scale.view(-1, layer.w2_weight_scale.shape[-1]),
                self.num_experts,
                False,
            )

            layer.w13_bias.data = (
                layer.w13_bias.data.view(-1, n // 2, 2)
                .permute(0, 2, 1)
                .contiguous()
                .view(-1, n)
            )

            layer.w13_weight_scale = torch.nn.Parameter(
                shuffled_w13_scale, requires_grad=False
            )
            layer.w2_weight_scale = torch.nn.Parameter(
                shuffled_w2_scale, requires_grad=False
            )
            # replace_parameter(layer, "w13_bias", w13_bias)
            # replace_parameter(layer, "w13_weight_scale", w13_weight_scale)
            # replace_parameter(layer, "w2_weight_scale", w2_weight_scale)
            # replace_parameter(layer, "w13_weight", w13_weight)
            # replace_parameter(layer, "w2_weight", w2_weight)

892
        elif self.mxfp4_backend == Mxfp4Backend.TRITON:
893
894
895
896
897
898
899
            from triton_kernels.matmul_ogs import FlexCtx, PrecisionConfig

            w13_bias = layer.w13_bias.to(torch.float32)
            w2_bias = layer.w2_bias.to(torch.float32)

            layer.w13_bias = Parameter(w13_bias, requires_grad=False)
            layer.w2_bias = Parameter(w2_bias, requires_grad=False)
900
901
902
903
904
            # Ideally we'd use FusedMoEModularKernel.prepare_finalize object
            # (stored in self.fused_experts) to determine if the MoE has a
            # batched activation format. As self.fused_experts is not
            # initialized at this point, we resort to checking the MoE config
            # directly.
905
906
907
            is_batched_moe = (
                self.moe.use_deepep_ll_kernels or self.moe.use_nixl_ep_kernels
            )
908
            if is_batched_moe:
909
910
911
912
                num_warps = 4 if envs.VLLM_MOE_DP_CHUNK_SIZE <= 512 else 8
            else:
                num_warps = 8
            w13_weight, w13_flex, w13_scale = _swizzle_mxfp4(
913
914
                layer.w13_weight, layer.w13_weight_scale, num_warps
            )
915
            w2_weight, w2_flex, w2_scale = _swizzle_mxfp4(
916
917
                layer.w2_weight, layer.w2_weight_scale, num_warps
            )
918
919

            self.w13_precision_config = PrecisionConfig(
920
921
                weight_scale=w13_scale, flex_ctx=FlexCtx(rhs_data=w13_flex)
            )
922
            self.w2_precision_config = PrecisionConfig(
923
924
                weight_scale=w2_scale, flex_ctx=FlexCtx(rhs_data=w2_flex)
            )
925
926
            self.w13_weight = w13_weight
            self.w2_weight = w2_weight
927
928
929
930
            del layer.w13_weight
            del layer.w2_weight
            layer.w13_weight = w13_weight
            layer.w2_weight = w2_weight
931

932
        else:
933
934
935
936
            raise ValueError(
                f"Unsupported mxfp4_backend: {self.mxfp4_backend}: "
                f"should be one of: {list(Mxfp4Backend)}."
            )
937

938
    def get_fused_moe_quant_config(
939
        self, layer: torch.nn.Module
940
    ) -> FusedMoEQuantConfig | None:
941
        if self.mxfp4_backend == Mxfp4Backend.MARLIN:
942
943
944
945
946
947
948
            return mxfp4_w4a16_moe_quant_config(
                w1_bias=layer.w13_bias,
                w2_bias=layer.w2_bias,
                w1_scale=layer.w13_weight_scale,
                w2_scale=layer.w2_weight_scale,
            )
        elif self.mxfp4_backend == Mxfp4Backend.TRITON:
949
950
            w1_scale = self.w13_precision_config
            w2_scale = self.w2_precision_config
951
952
953
954
955
956
            return mxfp4_w4a16_moe_quant_config(
                w1_bias=layer.w13_bias,
                w2_bias=layer.w2_bias,
                w1_scale=w1_scale,
                w2_scale=w2_scale,
            )
957
958
959
960
961
962
963
964
965
966
        elif self.mxfp4_backend in [
            Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM,
            Mxfp4Backend.SM100_FI_MXFP4_MXFP8_CUTLASS,
        ]:
            return mxfp4_mxfp8_moe_quant_config(
                w1_bias=layer.w13_bias,
                w2_bias=layer.w2_bias,
                w1_scale=layer.w13_weight_scale,
                w2_scale=layer.w2_weight_scale,
            )
967
968
969
        elif self.mxfp4_backend in [
            Mxfp4Backend.SM100_FI_MXFP4_BF16,
            Mxfp4Backend.SM90_FI_MXFP4_BF16,
970
            Mxfp4Backend.CK,
971
        ]:
972
973
974
975
976
977
            return mxfp4_w4a16_moe_quant_config(
                w1_bias=layer.w13_bias,
                w2_bias=layer.w2_bias,
                w1_scale=layer.w13_weight_scale,
                w2_scale=layer.w2_weight_scale,
            )
978
979
980
        else:
            w1_scale = layer.w13_weight_scale
            w2_scale = layer.w2_weight_scale
981
982
            return ocp_mx_moe_quant_config(
                quant_dtype="mxfp4",
983
984
985
986
987
                w1_bias=layer.w13_bias,
                w2_bias=layer.w2_bias,
                w1_scale=w1_scale,
                w2_scale=w2_scale,
            )
988

989
990
    def select_gemm_impl(
        self,
991
        prepare_finalize: mk.FusedMoEPrepareAndFinalizeModular,
992
        layer: torch.nn.Module,
993
    ) -> mk.FusedMoEExpertsModular:
994
995
996
997
        if (
            prepare_finalize.activation_format
            == mk.FusedMoEActivationFormat.BatchedExperts
        ):
998
999
1000
1001
1002
1003
1004
1005
            if self.mxfp4_backend == Mxfp4Backend.MARLIN:
                max_num_tokens_per_rank = prepare_finalize.max_num_tokens_per_rank()
                assert max_num_tokens_per_rank is not None
                assert self.moe_quant_config is not None
                return BatchedMarlinExperts(
                    max_num_tokens=max_num_tokens_per_rank,
                    num_dispatchers=prepare_finalize.num_dispatchers(),
                    quant_config=self.moe_quant_config,
1006
                    moe_config=self.moe,
1007
1008
1009
                )
            else:
                raise NotImplementedError(
1010
1011
                    f"Incompatible Mxfp4 backend ({self.mxfp4_backend}) for "
                    "EP batched experts format"
1012
                )
1013
        else:
1014
            assert self.moe_quant_config is not None
1015
1016
1017
1018
            if (
                self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM
                or self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_BF16
            ):
1019
1020
                # B200 code-path
                kwargs = {
1021
                    # TODO(bnell): part of quant_config
1022
1023
                    "max_capture_size": self.max_capture_size,
                }
1024
1025
                return TrtLlmGenExperts(self.moe, self.moe_quant_config, **kwargs)
            elif self.mxfp4_backend == Mxfp4Backend.MARLIN:
1026
                return MarlinExperts(self.moe, self.moe_quant_config)
1027
            elif self.mxfp4_backend == Mxfp4Backend.TRITON:
1028
                if self.moe.is_lora_enabled:
1029
1030
                    return UnfusedOAITritonExperts(self.moe, self.moe_quant_config)
                return OAITritonExperts(self.moe, self.moe_quant_config)
1031
1032
1033
1034
            else:
                raise NotImplementedError(
                    f"Incompatible Mxfp4 backend ({self.mxfp4_backend}) for EP"
                )
1035

1036
1037
    @property
    def is_monolithic(self) -> bool:
1038
1039
        if self.moe.is_lora_enabled:
            return False
1040
1041
1042
1043
        return (
            self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM
            or self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_BF16
            or self.mxfp4_backend == Mxfp4Backend.TRITON
1044
            or self.mxfp4_backend == Mxfp4Backend.CK
1045
1046
        )

1047
1048
    def apply(
        self,
1049
        layer: FusedMoE,
1050
        x: torch.Tensor,
1051
1052
        topk_weights: torch.Tensor,
        topk_ids: torch.Tensor,
1053
        shared_experts_input: torch.Tensor | None,
1054
    ) -> torch.Tensor | tuple[torch.Tensor, torch.Tensor]:
1055
        assert not self.is_monolithic
1056
        if layer.enable_eplb:
1057
1058
1059
            raise NotImplementedError("EPLB is not supported for mxfp4")

        assert _can_support_mxfp4(
1060
1061
1062
1063
1064
1065
1066
1067
1068
            layer.use_grouped_topk,
            layer.topk_group,
            layer.num_expert_group,
            layer.expert_map,
            layer.custom_routing_function,
            layer.e_score_correction_bias,
            layer.apply_router_weight_on_input,
            layer.scoring_func,
            layer.activation,
1069
1070
1071
            layer.eplb_state.expert_load_view,
            layer.eplb_state.logical_to_physical_map,
            layer.eplb_state.logical_replica_count,
1072
1073
        ), "MXFP4 are not supported with this configuration."

1074
1075
1076
        assert (
            self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_CUTLASS
            or self.mxfp4_backend == Mxfp4Backend.SM90_FI_MXFP4_BF16
1077
            or self.mxfp4_backend == Mxfp4Backend.MARLIN
1078
1079
        )

1080
1081
        assert self.moe_kernel is not None
        return self.moe_kernel.apply(
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
            hidden_states=x,
            w1=layer.w13_weight,
            w2=layer.w2_weight,
            topk_weights=topk_weights,
            topk_ids=topk_ids,
            activation=layer.activation,
            global_num_experts=layer.global_num_experts,
            apply_router_weight_on_input=layer.apply_router_weight_on_input,
            expert_map=layer.expert_map,
            shared_experts_input=shared_experts_input,
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
        )

    def apply_monolithic(
        self,
        layer: FusedMoE,
        x: torch.Tensor,
        router_logits: torch.Tensor,
    ) -> torch.Tensor | tuple[torch.Tensor, torch.Tensor]:
        assert self.is_monolithic

        if layer.enable_eplb:
            raise NotImplementedError("EPLB is not supported for mxfp4")

        assert _can_support_mxfp4(
            layer.use_grouped_topk,
            layer.topk_group,
            layer.num_expert_group,
            layer.expert_map,
            layer.custom_routing_function,
            layer.e_score_correction_bias,
            layer.apply_router_weight_on_input,
            layer.scoring_func,
            layer.activation,
            layer.eplb_state.expert_load_view,
            layer.eplb_state.logical_to_physical_map,
            layer.eplb_state.logical_replica_count,
        ), "MXFP4 are not supported with this configuration."

1120
1121
1122
1123
1124
1125
        # Apply routing simulation strategy if specified.
        # This applies to all monolithic backends (SM100_FI and TRITON).
        routing_strategy = envs.VLLM_MOE_ROUTING_SIMULATION_STRATEGY
        if routing_strategy == "uniform_random":
            router_logits = torch.rand_like(router_logits)

1126
1127
1128
1129
        if (
            self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM
            or self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_BF16
        ):
1130
            from flashinfer import trtllm_fp4_block_scale_moe
1131

1132
            if self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_BF16:
1133
1134
1135
                assert x.dtype == torch.bfloat16
                x_quant = x
                x_scale = None
1136
1137
            elif self.mxfp4_backend == Mxfp4Backend.SM100_FI_MXFP4_MXFP8_TRTLLM:
                from flashinfer import mxfp8_quantize
1138

1139
1140
1141
1142
1143
1144
                # x_quant is padded in hidden dimension with alignment=256
                x_quant, x_scale = mxfp8_quantize(
                    x,
                    is_sf_swizzled_layout=False,
                    alignment=256,
                )
1145
                x_scale = x_scale.view(torch.float8_e4m3fn).reshape(*x.shape[:-1], -1)
1146

1147
1148
1149
            # output with original unpadded hidden size
            output = torch.empty_like(x)

1150
            trtllm_gen_output = trtllm_fp4_block_scale_moe(
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
                routing_logits=router_logits.to(torch.bfloat16),
                routing_bias=None,
                hidden_states=x_quant,
                hidden_states_scale=x_scale,
                gemm1_weights=layer.w13_weight,  # uint8 (e2m1 x 2)
                gemm1_weights_scale=layer.w13_weight_scale,  # uint8 (e4m3 x 2)
                gemm1_bias=layer.w13_bias,  # fp32 per expert per channel
                gemm1_alpha=layer.gemm1_alpha,  # fp32 per expert
                gemm1_beta=layer.gemm1_beta,  # fp32 per expert
                gemm1_clamp_limit=layer.gemm1_clamp_limit,  # fp32 per expert
                gemm2_weights=layer.w2_weight,  # uint8 (e2m1 x 2)
                gemm2_weights_scale=layer.w2_weight_scale,  # ue8m0
                gemm2_bias=layer.w2_bias,  # fp32 per expert per channel
                output1_scale_scalar=None,
                output1_scale_gate_scalar=None,
                output2_scale_scalar=None,
                num_experts=layer.global_num_experts,
                top_k=layer.top_k,
                n_group=None,
                topk_group=None,
                intermediate_size=self.intermediate_size,  # padded to multiple of 256
                local_expert_offset=layer.ep_rank * layer.local_num_experts,
                local_num_experts=self.num_experts,
                routed_scaling_factor=None,
                routing_method_type=1 if layer.renormalize else 0,
                do_finalize=True,
1177
                tune_max_num_tokens=max(self.max_capture_size, 1),
1178
                output=output,
1179
1180
            )[0]
            return trtllm_gen_output
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
        elif self.mxfp4_backend == Mxfp4Backend.CK:
            topk_weights, topk_ids = rocm_aiter_ops.fused_topk(
                x, router_logits, layer.top_k, True
            )
            output = rocm_aiter_ops.fused_moe(
                x,
                layer.w13_weight,
                layer.w2_weight,
                topk_weights,
                topk_ids,
                activation_method=rocm_aiter_ops.get_aiter_activation_type("swiglu"),
                quant_method=rocm_aiter_ops.get_aiter_quant_type("per_1x32"),
                w1_scale=layer.w13_weight_scale,
                w2_scale=layer.w2_weight_scale,
                doweight_stage1=False,
                hidden_pad=self.hidden_pad // 128 * 128,
                intermediate_pad=self.intermediate_pad // 64 * 64 * 2,
                bias1=layer.w13_bias,
                bias2=layer.w2_bias,
            )
            return output
1202
        elif self.mxfp4_backend == Mxfp4Backend.TRITON:
1203
            from vllm.model_executor.layers.fused_moe.gpt_oss_triton_kernels_moe import (  # noqa: E501
1204
1205
1206
                triton_kernel_moe_forward,
            )

1207
1208
            return triton_kernel_moe_forward(
                hidden_states=x,
1209
1210
                w1=layer.w13_weight,
                w2=layer.w2_weight,
1211
                gating_output=router_logits,
1212
1213
1214
1215
                topk=layer.top_k,
                renormalize=layer.renormalize,
                global_num_experts=layer.global_num_experts,
                expert_map=layer.expert_map,
1216
                quant_config=self.moe_quant_config,
1217
                apply_router_weight_on_input=layer.apply_router_weight_on_input,
1218
            )
1219
1220
        else:
            raise ValueError(f"Unsupported backend: {self.mxfp4_backend}")
1221
1222


1223
class XpuMxfp4MoEMethod(Mxfp4MoEMethod):
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
    def __init__(self, moe_config: FusedMoEConfig):
        super().__init__(moe_config)
        self.moe_config = moe_config

    def create_weights(
        self,
        layer: torch.nn.Module,
        num_experts: int,
        hidden_size: int,
        intermediate_size_per_partition: int,
        params_dtype: torch.dtype,
        **extra_weight_attrs,
    ):
        super().create_weights(
            layer,
            num_experts,
            hidden_size,
            intermediate_size_per_partition,
            params_dtype,
            **extra_weight_attrs,
        )
        self.original_hidden_size = hidden_size

    def process_weights_after_loading(self, layer: torch.nn.Module) -> None:
1248
        pass
1249

1250
1251
1252
1253
1254
    @property
    def is_monolithic(self) -> bool:
        return True

    def apply_monolithic(
1255
        self,
1256
        layer: FusedMoE,
1257
1258
1259
        x: torch.Tensor,
        router_logits: torch.Tensor,
    ) -> torch.Tensor:
1260
1261
1262
        assert layer.activation == MoEActivation.SWIGLUOAI, (
            "Only swiglu_oai activation is supported for "
            f"XPU MXFP4 MoE, not {layer.activation}."
1263
        )
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
        from vllm_xpu_kernels.fused_moe_interface import xpu_fused_moe

        M, _ = x.size()
        routing_weights = torch.empty(
            M, layer.top_k, dtype=torch.float32, device=x.device
        )
        selected_experts = torch.empty(
            M, layer.top_k, dtype=torch.int32, device=x.device
        )
        token_expert_indices = torch.empty(
            M, layer.top_k, dtype=torch.int32, device=x.device
        )

        if layer.use_grouped_topk:
            routing_weights, selected_experts = torch.ops._moe_C.fused_grouped_topk(
                x,
                router_logits,
                layer.top_k,
                layer.renormalize,
                n_expert_group=layer.num_expert_group,
                n_topk_group=layer.topk_group,
                scoring_func=layer.scoring_func,
                routed_scaling_factor=layer.routed_scaling_factor,
                bias=layer.e_score_correction_bias,
            )
        else:
            torch.ops._moe_C.topk_softmax(
                routing_weights,
                selected_experts,
                token_expert_indices,
                router_logits,
                layer.renormalize,
                layer.e_score_correction_bias,
            )

        return xpu_fused_moe(
            hidden_states=x,
            w13=layer.w13_weight,
            w13_bias=layer.w13_bias if self.moe.has_bias else None,
            w13_scales=layer.w13_weight_scale,
            w2=layer.w2_weight,
            w2_bias=layer.w2_bias if self.moe.has_bias else None,
            w2_scales=layer.w2_weight_scale,
            topk_weights=routing_weights,
            topk_ids=selected_experts,
            n_experts_per_token=layer.top_k,
1310
            activation=layer.activation.value,
1311
1312
            num_experts=layer.local_num_experts,
            is_mxfp4=True,
1313
        )