# SPDX-License-Identifier: Apache-2.0 # SPDX-FileCopyrightText: Copyright contributors to the vLLM project """INT8 quantization config for diffusion transformers. Supports both online (dynamic) and offline (checkpoint) INT8 quantization on CUDA and NPU platforms. """ from collections.abc import Callable from typing import TYPE_CHECKING, Any, Optional import torch from torch.nn import Module from vllm import _custom_ops as ops from vllm.logger import init_logger from vllm.model_executor.kernels.linear import ( init_int8_linear_kernel, ) from vllm.model_executor.layers.linear import ( LinearBase, LinearMethodBase, UnquantizedLinearMethod, ) from vllm.model_executor.layers.quantization import QuantizationMethods from vllm.model_executor.layers.quantization.base_config import ( QuantizationConfig, QuantizeMethodBase, ) from vllm.model_executor.layers.quantization.fp8 import CopyNumelCounter, _copy_missing_attrs from vllm.model_executor.layers.quantization.utils.quant_utils import ( is_layer_skipped, ) from vllm.model_executor.model_loader.weight_utils import initialize_single_dummy_weight from vllm.model_executor.parameter import ( ChannelQuantScaleParameter, ModelWeightParameter, ) from vllm.model_executor.utils import replace_parameter from vllm_omni.platforms import current_omni_platform if current_omni_platform.is_npu(): import torch_npu else: torch_npu = None if TYPE_CHECKING: from vllm.model_executor.models.utils import WeightsMapper # Dynamic quantization is supported first. ACTIVATION_SCHEMES = ["dynamic"] logger = init_logger(__name__) def create_weight_parameter( output_size_per_partition: int, input_size_per_partition: int, weight_loader: Callable | None, params_dtype: torch.dtype, ) -> torch.nn.Parameter: """ Create int8 weight parameter. """ return ModelWeightParameter( data=torch.empty( output_size_per_partition, input_size_per_partition, dtype=params_dtype, ), input_dim=1, output_dim=0, weight_loader=weight_loader, ) class DiffusionInt8Config(QuantizationConfig): """INT8 quantization config for diffusion transformers. Supports online (dynamic) quantization from BF16/FP16 checkpoints and offline quantization from serialized INT8 checkpoints. Works on both CUDA and NPU platforms. """ def __init__( self, is_checkpoint_int8_serialized: bool = False, activation_scheme: str = "dynamic", ignored_layers: list[str] | None = None, ) -> None: super().__init__() self.is_checkpoint_int8_serialized = is_checkpoint_int8_serialized if activation_scheme not in ACTIVATION_SCHEMES: raise ValueError(f"Unsupported activation scheme {activation_scheme}") self.activation_scheme = activation_scheme self.ignored_layers = ignored_layers or [] @classmethod def get_name(cls) -> QuantizationMethods: return "int8" @classmethod def get_supported_act_dtypes(cls) -> list[torch.dtype]: return [torch.bfloat16, torch.float16] @classmethod def get_min_capability(cls) -> int: # Have verified on A100 and H20, but not on oldest versions. return 80 @classmethod def get_config_filenames(cls) -> list[str]: return [] def apply_vllm_mapper(self, hf_to_vllm_mapper: "WeightsMapper"): if self.ignored_layers is not None: self.ignored_layers = hf_to_vllm_mapper.apply_list(self.ignored_layers) @classmethod def from_config(cls, config: dict[str, Any]) -> "DiffusionInt8Config": quant_method = cls.get_from_keys(config, ["quant_method"]) is_checkpoint_int8_serialized = "int8" in quant_method activation_scheme = cls.get_from_keys_or(config, ["activation_scheme"], "dynamic") ignored_layers = cls.get_from_keys_or(config, ["ignored_layers"], None) if not ignored_layers: ignored_layers = cls.get_from_keys_or(config, ["modules_to_not_convert"], None) return cls( is_checkpoint_int8_serialized=is_checkpoint_int8_serialized, activation_scheme=activation_scheme, ignored_layers=ignored_layers, ) def get_quant_method( self, layer: torch.nn.Module, prefix: str, ) -> Optional["QuantizeMethodBase"]: if isinstance(layer, LinearBase): if is_layer_skipped( prefix=prefix, ignored_layers=self.ignored_layers, fused_mapping=self.packed_modules_mapping, ): return UnquantizedLinearMethod() if not self.is_checkpoint_int8_serialized: if current_omni_platform.is_cuda(): online_method = Int8OnlineLinearMethod(self) elif current_omni_platform.is_npu(): online_method = NPUInt8OnlineLinearMethod(self) else: raise NotImplementedError("The current platform is not supported int8 online quant.") return online_method else: if current_omni_platform.is_cuda(): offline_method = Int8LinearMethod(self) elif current_omni_platform.is_npu(): offline_method = NPUInt8LinearMethod(self) else: raise NotImplementedError("The current platform is not supported int8 offline quant.") return offline_method return None class BaseInt8LinearMethod(LinearMethodBase): """ Linear method for Int8 Supports loading Int8 checkpoints with static weight scale and dynamic activation scale. Args: quant_config: The quantization config. """ def __init__(self, quant_config: DiffusionInt8Config): self.quant_config = quant_config self.out_dtype = torch.get_default_dtype() def create_weights( self, layer: torch.nn.Module, input_size_per_partition: int, output_partition_sizes: list[int], input_size: int, output_size: int, params_dtype: torch.dtype, **extra_weight_attrs, ): output_size_per_partition = sum(output_partition_sizes) weight_loader = extra_weight_attrs.get("weight_loader") layer.logical_widths = output_partition_sizes layer.input_size_per_partition = input_size_per_partition layer.output_size_per_partition = output_size_per_partition layer.orig_dtype = params_dtype params_dtype = torch.int8 if self.quant_config.is_checkpoint_int8_serialized else params_dtype weight = create_weight_parameter( output_size_per_partition=output_size_per_partition, input_size_per_partition=input_size_per_partition, weight_loader=weight_loader, params_dtype=params_dtype, ) layer.register_parameter("weight", weight) if self.quant_config.is_checkpoint_int8_serialized: scale = ChannelQuantScaleParameter( data=torch.empty((sum(output_partition_sizes), 1), dtype=torch.float32), output_dim=0, weight_loader=weight_loader, ) layer.register_parameter("weight_scale", scale) def process_weights_after_loading(self, layer: Module) -> None: raise NotImplementedError("No BaseInt8LinearMethod process_weights_after_loading implementation.") def apply( self, layer: torch.nn.Module, x: torch.Tensor, bias: torch.Tensor | None = None, ) -> torch.Tensor: raise NotImplementedError("No BaseInt8LinearMethod apply implementation.") class LazyWeightMixin: """ Mixin for lazy weight loading with meta device. weighs are created on meta device and materialized just-in-time during loadding. """ uses_meta_device: bool = True def create_weights( self, layer: torch.nn.Module, input_size_per_partition: int, output_partition_sizes: list[int], input_size: int, output_size: int, params_dtype: torch.dtype, **extra_weight_attrs, ): output_size_per_partition = sum(output_partition_sizes) weight_loader = extra_weight_attrs.get("weight_loader") layer.logical_widths = output_partition_sizes layer.input_size_per_partition = input_size_per_partition layer.output_size_per_partition = output_size_per_partition layer.orig_dtype = params_dtype layer.weight_block_size = None # WEIGHT def patched_weight_loader(param, loaded_weight, *args, **kwargs): # track how many elements we have updated if not hasattr(layer, "_loaded_numel"): layer._loaded_numel = 0 # when the first `loaded_weight` is about to be # loaded to `param`, materialize `param` just-in-time weight = ModelWeightParameter( data=torch.empty_like(layer.weight, device=layer._load_device), input_dim=1, output_dim=0, weight_loader=patched_weight_loader, ) _copy_missing_attrs(layer.weight, weight) layer.register_parameter("weight", weight) del layer._load_device # refresh the reference to `param` to reflect just-in-time # materialization param = layer.weight # load the current weight chunk copy_numel_counter = CopyNumelCounter() with copy_numel_counter: res = weight_loader(param, loaded_weight, *args, **kwargs) # type: ignore[misc] layer._loaded_numel += copy_numel_counter.copied_numel # if we have loaded all of the elements, call # process_weights_after_loading target_loaded_numel = layer.weight.numel() if layer._loaded_numel == target_loaded_numel: self.process_weights_after_loading(layer) # Prevent the usual `process_weights_after_loading` call from doing # anything layer._already_called_process_weights_after_loading = True # Note that we keep `layer._loaded_numel` around just in case # there is logic added to vllm in the future which calls a # weight loader twice - we do not want to re-initialize in # that case. return res weight = ModelWeightParameter( data=torch.empty( output_size_per_partition, input_size_per_partition, # materialized just-in-time in `patched_weight_loader` device="meta", dtype=params_dtype, ), input_dim=1, output_dim=0, weight_loader=patched_weight_loader, ) # stash the correct device for `patched_weight_loader` layer._load_device = torch.get_default_device() layer.register_parameter("weight", weight) class Int8LinearMethod(BaseInt8LinearMethod): """ Linear method for Int8 Supports loading Int8 checkpoints. Args: quant_config: The quantization config. """ def __init__(self, quant_config: DiffusionInt8Config): super().__init__(quant_config) self.int8_linear = init_int8_linear_kernel( is_channelwise=False, is_static_input_scheme=False, input_symmetric=True, module_name=self.__class__.__name__, ) def process_weights_after_loading(self, layer: Module) -> None: self.int8_linear.process_weights_after_loading(layer) def apply( self, layer: torch.nn.Module, x: torch.Tensor, bias: torch.Tensor | None = None, ) -> torch.Tensor: return self.int8_linear.apply_weights(layer, x, bias) class NPUInt8LinearMethod(BaseInt8LinearMethod): """ NPU Linear method for Int8 Supports loading Int8 checkpoints. Args: quant_config: The quantization config. """ def __init__(self, quant_config: DiffusionInt8Config): super().__init__(quant_config) def process_weights_after_loading(self, layer: Module) -> None: layer.weight.data = layer.weight.data.t().contiguous() layer.weight_scale.data = layer.weight_scale.data.squeeze() def apply( self, layer: torch.nn.Module, x: torch.Tensor, bias: torch.Tensor | None = None, ) -> torch.Tensor: ori_shape = x.shape ori_dtype = x.dtype x = x.reshape(-1, ori_shape[-1]) quantized_x, pertoken_scale = torch_npu.npu_dynamic_quant(x) output = torch_npu.npu_quant_matmul( quantized_x, layer.weight, layer.weight_scale, bias=bias, pertoken_scale=pertoken_scale, output_dtype=ori_dtype, ) output = output.reshape(*ori_shape[:-1], -1) return output class Int8OnlineLinearMethod(LazyWeightMixin, Int8LinearMethod): """ Online version of Int8LinearMethod, loads the fp16/bf16 checkpoint and quantized the weights during loading. """ def process_weights_after_loading(self, layer: Module) -> None: if getattr(layer, "_already_called_process_weights_after_loading", False): return if layer.weight.device == torch.device("meta"): weight = ModelWeightParameter( data=torch.empty_like(layer.weight, device=layer._load_device), input_dim=1, output_dim=0, weight_loader=layer.weight.weight_loader, ) _copy_missing_attrs(layer.weight, weight) layer.register_parameter("weight", weight) initialize_single_dummy_weight(layer.weight) w_q_name, w_s_name, i_s_name, i_zp_name, azp_adj_name = self.int8_linear.layer_param_names qweight, weight_scale, _ = ops.scaled_int8_quant(layer.weight, scale=None) # Update layer with new values. replace_parameter(layer, w_q_name, torch.nn.Parameter(qweight.t().data, requires_grad=False)) replace_parameter(layer, w_s_name, torch.nn.Parameter(weight_scale.data, requires_grad=False)) setattr(layer, i_s_name, None) setattr(layer, i_zp_name, None) setattr(layer, azp_adj_name, None) # Prevent duplicate processing (e.g., during weight reload) layer._already_called_process_weights_after_loading = True class NPUInt8OnlineLinearMethod(LazyWeightMixin, NPUInt8LinearMethod): """ NPU Online version of Int8LinearMethod, loads the fp16/bf16 checkpoint and quantized the weights during loading. """ def process_weights_after_loading(self, layer: Module) -> None: if getattr(layer, "_already_called_process_weights_after_loading", False): return if layer.weight.device == torch.device("meta"): weight = ModelWeightParameter( data=torch.empty_like(layer.weight, device=layer._load_device), input_dim=1, output_dim=0, weight_loader=layer.weight.weight_loader, ) _copy_missing_attrs(layer.weight, weight) layer.register_parameter("weight", weight) initialize_single_dummy_weight(layer.weight) weight = layer.weight qweight, weight_scale = torch_npu.npu_dynamic_quant(weight) qweight = qweight.t().contiguous() # Update layer with new values. replace_parameter(layer, "weight", qweight) replace_parameter(layer, "weight_scale", weight_scale) # Prevent duplicate processing (e.g., during weight reload) layer._already_called_process_weights_after_loading = True