vllm - 💡(How to fix) Fix [Bug]: Multiple model files still trigger ImageProcessorFast DeprecationWarning post transformers v5.4 refactor [1 pull requests]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Fix Action

Fixed

Code Example

$ docker run --rm --gpus '"device=1"' --entrypoint python3 \
    vllm/vllm-openai:v0.20.0 -W default -c \
    "import vllm.model_executor.models.lfm2_vl"
[transformers] Accessing `Lfm2VlImageProcessorFast` from `.models.lfm2_vl.image_processing_lfm2_vl`.
Returning `Lfm2VlImageProcessor` instead. Behavior may be different and this alias
will be removed in future versions.
RAW_BUFFERClick to expand / collapse

What

Static imports of deprecated *ImageProcessorFast symbols still trigger transformers DeprecationWarning across four model files under vllm/model_executor/models/. #42700 fixed the same family for qwen3_vl.py (one file); the other four were not covered.

Reproduction

$ docker run --rm --gpus '"device=1"' --entrypoint python3 \
    vllm/vllm-openai:v0.20.0 -W default -c \
    "import vllm.model_executor.models.lfm2_vl"
[transformers] Accessing `Lfm2VlImageProcessorFast` from `.models.lfm2_vl.image_processing_lfm2_vl`.
Returning `Lfm2VlImageProcessor` instead. Behavior may be different and this alias
will be removed in future versions.

Same form of warning fires on each of:

FileImported symbolReplacement (per transformers warning text)
vllm/model_executor/models/lfm2_vl.pyLfm2VlImageProcessorFast (+ find_closest_aspect_ratio, round_by_factor from the deprecated submodule path)Lfm2VlImageProcessor
vllm/model_executor/models/gemma3n_mm.pySiglipImageProcessorFastSiglipImageProcessor
vllm/model_executor/models/interns1.pyGotOcr2ImageProcessorFastGotOcr2ImageProcessor
vllm/model_executor/models/cohere2_vision.pyCohere2VisionImageProcessorFastCohere2VisionImageProcessor

Sanity check the inverse: vllm/transformers_utils/processors/{qwen_vl,glm4v}.py define internal classes that inherit BaseImageProcessorFast. The same probe does not raise any warning for these — BaseImageProcessorFast is still the canonical export. So the surface is import-site only, four files.

Background

  • huggingface/transformers#43514 (merged 2026-03-19, "🚨🚨 Refactor Image Processors to support different backends") dropped the Fast suffix for image processors and reshaped the underlying class layout.
  • vLLM's requirements/common.txt already pins around the breaking transitions (!= 5.4.*, != 5.5.0), but the import-site warnings on the four files above remain visible on every load.

Question for maintainers

Same as #42688's resolution — swap the imports for the un-suffixed canonical names across these four files, mirroring #42700's pattern.

I'll send the follow-up PR shortly. Happy to scope it differently if there's an internal sweep planned.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

vllm - 💡(How to fix) Fix [Bug]: Multiple model files still trigger ImageProcessorFast DeprecationWarning post transformers v5.4 refactor [1 pull requests]