from typing import TYPE_CHECKING from ..utils import is_accelerate_available, is_torch_available, is_torch_xpu_available, logging from .base import HfQuantizer from .quantizers_utils import get_module_from_name if is_torch_available(): import torch if TYPE_CHECKING: from ..modeling_utils import PreTrainedModel logger = logging.get_logger(__name__) class FineGrainedFP8HfQuantizer(HfQuantizer): """ FP8 quantization implementation supporting both standard and MoE models. Supports both e4m3fn formats based on platform. """ requires_calibration = False def __init__(self, quantization_config, **kwargs): super().__init__(quantization_config, **kwargs) def validate_environment(self, *args, **kwargs): if not is_accelerate_available(): raise ImportError("Loading an FP8 quantized model requires accelerate (`pip install accelerate`)") if self.quantization_config.dequantize: return if not torch.cuda.is_available() and not is_torch_xpu_available(): if self.pre_quantized: logger.warning_once( "Using FP8 quantized models requires a GPU or XPU, we will default to dequantizing the model to bf16 since no GPU or XPU is available" ) self.quantization_config.dequantize = True return else: raise RuntimeError("No GPU or XPU found. A GPU or XPU is needed for FP8 quantization.") if torch.cuda.is_available(): compute_capability = torch.cuda.get_device_capability() major, minor = compute_capability if (major < 8) or (major == 8 and minor < 9): logger.warning_once( "FP8 quantized models is only supported on GPUs with compute capability >= 8.9 (e.g 4090/H100)" f", actual = `{major}.{minor}`. We will default to dequantizing the model to bf16. Feel free " f"to use a different quantization method like bitsandbytes or torchao" ) self.quantization_config.dequantize = True return device_map = kwargs.get("device_map") if device_map is None: logger.warning_once( "You have loaded an FP8 model on CPU and have a CUDA or XPU device available, make sure to set " "your model on a GPU or XPU device in order to run your model. To remove this warning, " "pass device_map = 'cuda' or 'xpu'. " ) elif isinstance(device_map, dict): if ( not self.pre_quantized and len(device_map) > 1 and "cpu" in device_map.values() or "disk" in device_map.values() ): raise ValueError( "You are attempting to load an FP8 model with a device_map that contains a cpu/disk device." "This is not supported when the model is quantized on the fly. " "Please use a quantized checkpoint or remove the cpu/disk device from the device_map." ) def param_needs_quantization(self, model: "PreTrainedModel", param_name: str, **kwargs) -> bool: from ..integrations.finegrained_fp8 import FP8Expert, FP8Linear module, tensor_name = get_module_from_name(model, param_name) if isinstance(module, (FP8Linear, FP8Expert)): if self.pre_quantized or tensor_name == "bias": return False else: return True return False def param_element_size(self, model: "PreTrainedModel", param_name: str, param: "torch.Tensor") -> float: "Return the element size (in bytes) for `param_name`." if self.param_needs_quantization(model, param_name): # 8 bit, this is neeed as when `pre_quantized`` is False, we don't set the dtype of the FP8Linear in order to correctly load the weights return 1 return super().param_element_size(model, param_name, param) def _process_model_before_weight_loading( self, model: "PreTrainedModel", **kwargs, ): from ..integrations.finegrained_fp8 import replace_with_fp8_linear self.modules_to_not_convert = self.get_modules_to_not_convert( model, self.quantization_config.modules_to_not_convert, model._keep_in_fp32_modules ) model = replace_with_fp8_linear( model, modules_to_not_convert=self.modules_to_not_convert, quantization_config=self.quantization_config, pre_quantized=self.pre_quantized, ) def update_tp_plan(self, config): if "Qwen3" in config.__class__.__name__: text_plan = { "layers.*.self_attn.q_proj.weight": "colwise", "layers.*.self_attn.q_proj.weight_scale_inv": "colwise", "layers.*.self_attn.k_proj.weight": "colwise", "layers.*.self_attn.k_proj.weight_scale_inv": "colwise", "layers.*.self_attn.v_proj.weight": "colwise", "layers.*.self_attn.v_proj.weight_scale_inv": "colwise", "layers.*.self_attn.o_proj.weight": "rowwise", "layers.*.self_attn.o_proj.weight_scale_inv": "rowwise", "layers.*.mlp.gate_proj.weight": "colwise", "layers.*.mlp.gate_proj.weight_scale_inv": "colwise", "layers.*.mlp.up_proj.weight": "colwise", "layers.*.mlp.up_proj.weight_scale_inv": "colwise", "layers.*.mlp.down_proj.weight": "rowwise", "layers.*.mlp.down_proj.weight_scale_inv": "rowwise", } config.base_model_tp_plan = text_plan return config def is_serializable(self): return True @property def is_trainable(self) -> bool: return False def get_quantize_ops(self): from ..integrations.finegrained_fp8 import Fp8Quantize return Fp8Quantize(self) def get_weight_conversions(self): from ..core_model_loading import WeightConverter from ..integrations.finegrained_fp8 import Fp8Dequantize if self.pre_quantized and self.quantization_config.dequantize: return [ # either use the dollar sign, or permute the source patterns to start matching against the scales first # We also collect the activation scales, they will not be used WeightConverter( source_patterns=["weight$", "weight_scale_inv", "activation_scale"], target_patterns="weight", operations=[Fp8Dequantize(self)], ) ] return []