[diffusion] feat: reject unsupported quantized component checkpoints (#35873)

This commit is contained in:
Mick
2026-08-22 09:33:43 +08:00
committed by GitHub
parent 22dafbcbd9
commit b26695a26e
12 changed files with 297 additions and 61 deletions
@@ -716,6 +716,13 @@ component directory.
The same overrides can also be provided in config files through
`component_paths.<component>`.
Component path overrides are generic, but quantized checkpoint support is
loader-specific. Native SGLang loaders that only materialize plain state dicts
reject detected quantization metadata before weight loading instead of silently
casting the checkpoint into an unquantized module. Library-managed components
inherit the corresponding Transformers or Diffusers support. See
[Quantized Component Repositories](./quantization#quantized-component-repositories).
### Common Syntax
CLI:
@@ -818,7 +825,7 @@ The table below lists concrete Hugging Face component repos that are already use
### Transformer / DiT
- `--transformer-path` is the standard override for the main denoising transformer.
- For quantized transformers, prefer `--transformer-path` or `--transformer-weights-path`; see `quantization.md`.
- For a pre-quantized main transformer, prefer `--transformer-path` or `--transformer-weights-path`; see [Quantization](./quantization).
- `--video-dit-path` and `--audio-dit-path` are only for pipelines that split denoisers by modality.
### Text Encoders and Preprocessors
@@ -838,6 +845,10 @@ The table below lists concrete Hugging Face component repos that are already use
that component.
2. The override key should match the component name in the pipeline's
`model_index.json` or the native pipeline's registered module name.
3. An override path does not enable quantization by itself. A pre-quantized
component must include metadata for a format supported by its selected
loader. `--quantization` overrides the transformer loader; other component
checkpoints select their serialized format through their own metadata.
## Verified LoRA Examples