Skip to content

Support vLLM 0.12.0#4117

Merged
qgallouedec merged 17 commits intohuggingface:mainfrom
jiqing-feng:param
Jan 5, 2026
Merged

Support vLLM 0.12.0#4117
qgallouedec merged 17 commits intohuggingface:mainfrom
jiqing-feng:param

Conversation

@jiqing-feng
Copy link
Contributor

The latest vllm changed the guided_decoding to structured_outputs in this PR 22772. We also need to update this parameter in the vllm client and vllm serve.

Hi @qgallouedec . Would you please review this PR? Thanks!

@kashif
Copy link
Collaborator

kashif commented Sep 22, 2025

we will need to make sure that we require the version of vllm that supports this feature

@jiqing-feng
Copy link
Contributor Author

jiqing-feng commented Sep 22, 2025

we will need to make sure that we require the version of vllm that supports this feature

Sure, we can wait for the vllm release and then update the vllm version in setup in this PR.

@kashif
Copy link
Collaborator

kashif commented Sep 22, 2025

@jiqing-feng
Copy link
Contributor Author

you will need to update this: https://github.com/huggingface/trl/blob/main/setup.cfg#L67

Yes, exactly. I will update it once vllm 10.3.0 released.

Signed-off-by: jiqing-feng <jiqing.feng@intel.com>
@qgallouedec
Copy link
Member

for ref: #4122 will pin vLLM

@ed-pai
Copy link

ed-pai commented Dec 11, 2025

Issue tracking this PR: #4617

@jiqing-feng
Copy link
Contributor Author

Hi @kashif @qgallouedec . I have updated this PR. Please review it. Thanks!

Signed-off-by: jiqing-feng <jiqing.feng@intel.com>
Signed-off-by: jiqing-feng <jiqing.feng@intel.com>
Signed-off-by: jiqing-feng <jiqing.feng@intel.com>
@ed-pai
Copy link

ed-pai commented Dec 12, 2025

Thanks @jiqing-feng! BTW, it looks like you're pinning to <v0.12.0. What's the blocker now for v0.12.0? It was released last week.

@jiqing-feng
Copy link
Contributor Author

jiqing-feng commented Dec 15, 2025

Thanks @jiqing-feng! BTW, it looks like you're pinning to <v0.12.0. What's the blocker now for v0.12.0? It was released last week.

I just kept the original maximum version v0.12.0, it's not my change.

@ed-pai
Copy link

ed-pai commented Dec 16, 2025

My understanding is that TRL already worked with v0.11.2. This fix is required for support of v0.12.0.
It doesn't make sense to not allow that version in the pyproject.toml ("vllm>=0.10.3,<0.12.0").

@qgallouedec, wanted to ensure this PR was on your radar. Thanks!

@qgallouedec
Copy link
Member

Thanks for the PR. Indeed, TRL supports 0.10.2 - 0.11.2, but not 0.12, and this PR should allow to support 0.12. Ideally we would like to continue supporting 0.10.2 - 0.11.2, I'm not sure if this PR allows this, I'll need to check. I'll review it in details very soon.


> [!WARNING]
> TRL currently only supports vLLM versions `0.10.2`, `0.11.0`, `0.11.1`, and `0.11.2`. Please ensure you have one of these versions installed to avoid compatibility issues.
> TRL currently only supports vLLM versions `0.10.3`, `0.11.0`, `0.11.1`, and `0.11.2`. Please ensure you have one of these versions installed to avoid compatibility issues.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

0.10.3 is not a valid vllm version.

@qgallouedec
Copy link
Member

StructuredOutputsParams is not in vLLM 0.10.2. We should have a version check to import GuidedDecodingParams when vLLM version is 0.10.2, and StructuredOutputsParams otherwise. Also, to avoid breaking change, let's have 1 version of deprecation for vllm_guided_decoding_regex

Copy link
Member

@qgallouedec qgallouedec left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks! I modified a bit to ensure backward compatibility

@qgallouedec qgallouedec changed the title update guided decoding param to structured outputs Support vLLM 0.12.0 Jan 5, 2026
@HuggingFaceDocBuilderDev

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

@qgallouedec qgallouedec linked an issue Jan 5, 2026 that may be closed by this pull request
5 tasks
@qgallouedec qgallouedec merged commit 39ad00d into huggingface:main Jan 5, 2026
10 of 11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

VLLM deprecated GuidedDecodingParams -> StructuredOutputsParams

5 participants