vllm - ✅(Solved) Fix [CLI / Warning] Misleading deprecation warning around `vllm serve --model ...` arg [1 pull requests, 1 comments, 2 participants]

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…
GitHub stats
vllm-project/vllm#39506Fetched 2026-04-11 06:13:09
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
0
Participants
Timeline (top)
commented ×1cross-referenced ×1labeled ×1

Fix Action

Fixed

PR fix notes

PR #39518: [Misc] Update deprecation warning for --model flag

Description (problem / solution / changelog)

Purpose

Fixes #39506

Problem

The deprecation warning for the --model flag in vllm serve currently references removal in v0.13. Since vLLM is now at v0.19, this warning is outdated and misleading.

Solution

Update the warning message to refer to "a future version" instead of a specific outdated version, so it remains accurate for current and future users.


<details> <summary> Essential Elements of an Effective PR Description Checklist </summary>
  • The purpose of the PR, such as "Fix some issue (link existing issues this PR will resolve)".
  • The test plan, such as providing test command.
  • The test results, such as pasting the results comparison before and after, or e2e results
  • (Optional) The necessary documentation update, such as updating supported_models.md and examples for a new model.
  • (Optional) Release notes update. If your change is user facing, please update the release notes draft in the Google Doc.
</details>

Changed files

  • vllm/utils/argparse_utils.py (modified, +1/-1)
RAW_BUFFERClick to expand / collapse

📚 The doc issue

Hey,

I've been seeing the following warning for a while WARNING [argparse_utils.py:191] With vllm serve, you should provide the model as a positional argument or in a config file instead of via the --model option. The --model option will be removed in v0.13., and I was wondering when will that be really deprecated (if it will ever be), and if so to update the warning message for the actual version in which it'll be finally deprecated.

See https://github.com/vllm-project/vllm/blob/8d0f908b98cd692204753421dd39695f3094c8f0/vllm/utils/argparse_utils.py#L186-L217.

Thanks in advance 🤗

P.S. Apologies, but I thought that "documentation" was the best category that fits within this issue as neither of the existing categories matches this issue AFAIK, but apologies if that's the case!

Suggest a potential alternative/fix

No response

Before submitting a new issue...

  • Make sure you already searched for relevant issues, and asked the chatbot living at the bottom right corner of the documentation page, which can answer lots of frequently asked questions.

extent analysis

TL;DR

Update the warning message in argparse_utils.py to reflect the actual version in which the --model option will be deprecated.

Guidance

Notes

The issue lacks information about the current version and the planned deprecation schedule, so it's essential to review the code and documentation to determine the correct version for the warning message.

Recommendation

Apply workaround: Update the warning message to reflect the actual version in which the --model option will be deprecated, as this will provide clearer information to users and help them prepare for the change.

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 - ✅(Solved) Fix [CLI / Warning] Misleading deprecation warning around `vllm serve --model ...` arg [1 pull requests, 1 comments, 2 participants]