{"record":{"id":"af082990ff735f6d","repo":"sgl-project/sglang","slug":"a-quantized-component-name-r-checkpoint-requires-af0829","errorCode":null,"errorMessage":"A quantized {component_name!r} checkpoint requires an in-tree native encoder; unsupported architectures: {architectures}","messagePattern":"A quantized (.+?) checkpoint requires an in-tree native encoder; unsupported architectures: (.+?)","errorType":"validation","errorClass":"ComponentCheckpointUnsupportedError","httpStatus":null,"severity":"error","filePath":"python/sglang/multimodal_gen/runtime/loader/component_loaders/text_encoder_loader.py","lineNumber":352,"sourceCode":"        try:\n            quant_config = _get_encoder_quant_config(\n                component_config,\n                component_model_path,\n                component_weights_path,\n            )\n        except Exception as quantization_error:\n            raise ComponentCheckpointUnsupportedError(\n                f\"Cannot parse checkpoint quantization for {component_name!r}: \"\n                f\"{quantization_error}\"\n            ) from quantization_error\n        if explicit_quantization is not None and quant_config is None:\n            raise ComponentCheckpointUnsupportedError(\n                f\"Online quantization for {component_name!r} requires an in-tree \"\n                f\"native encoder; unsupported architectures: {architectures}\"\n            ) from resolution_error\n        if quant_config is None:\n            raise\n        raise ComponentCheckpointUnsupportedError(\n            f\"A quantized {component_name!r} checkpoint requires an in-tree \"\n            f\"native encoder; unsupported architectures: {architectures}\"\n        ) from resolution_error\n\n    _configure_encoder_quantization(\n        model_config,\n        model_cls,\n        component_config,\n        component_model_path,\n        component_weights_path,\n        component_name,\n        explicit_quantization,\n        ignored_layers,\n    )\n    return model_cls\n\n\ndef _process_quantized_encoder_weights(","sourceCodeStart":334,"sourceCodeEnd":370,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/multimodal_gen/runtime/loader/component_loaders/text_encoder_loader.py#L334-L370","documentation":"ComponentCheckpointUnsupportedError raised when the checkpoint itself declares quantization (quant_config is not None), architecture resolution already failed (resolution_error chained), and the original exception is re-raised wrapped: a quantized checkpoint cannot be loaded by a non-native (e.g. transformers-delegated) encoder. This is the checkpoint-side counterpart of 1347.","triggerScenarios":"load_customized on a component whose weights/config carry quantization metadata while config.json architectures resolve to no in-tree native encoder class — e.g. an FP8-serialized encoder with only transformers support.","commonSituations":"Downloading a community-quantized encoder checkpoint for an architecture sglang only delegates to transformers; mixing quantized component checkpoints into a pipeline that expects native implementations.","solutions":["Use an unquantized (BF16/FP16) checkpoint of this encoder architecture","Switch to an architecture variant with a native in-tree implementation that supports quantization","Dequantize the checkpoint offline before loading","If the architecture should be supported, check for typos in the architectures list of config.json"],"exampleFix":"# before\nweights = \"clip-community-fp8/\"  # arch not natively supported\n\n# after\nweights = \"clip-original-fp16/\"","handlingStrategy":"validation","validationCode":"native = resolve_native_encoder_class(architectures)\nquantized = checkpoint_declares_quant(model_path) or quant_config is not None\nif quantized and native is None:\n    raise SystemExit(\"use an unquantized checkpoint or a natively supported arch\")","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep unquantized fallback checkpoints for delegated encoder architectures","Verify architecture strings match registered native classes"],"tags":["quantization","architecture-unsupported","checkpoint","text-encoder"],"backgroundTag":"unsupported-model-architecture","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}