Skip to content

Update wordle tutorial to native vllm serve - #1082

Merged
sergiopaniego merged 3 commits into
mainfrom
update-wordle-vllm-serve
Oct 14, 2026
Merged

sergiopaniego merged 3 commits into
mainfrom
update-wordle-vllm-serve

Conversation

@sergiopaniego

@sergiopaniego sergiopaniego commented Aug 17, 2026 •

Copy link
Copy Markdown
Collaborator

What

Updates the vLLM server command in tutorial/examples/wordle.py from the deprecated trl vllm-serve to vLLM's native server, matching the migration in huggingface/trl#6765:

CUDA_VISIBLE_DEVICES=0 VLLM_SERVER_DEV_MODE=1 vllm serve Qwen/Qwen3-1.7B --host 0.0.0.0 --port 8000 \
    --weight-transfer-config '{"backend": "nccl"}' \
    --logprobs-mode processed_logprobs \
    --max-logprobs -1

TRL version

huggingface/trl#6765 shipped in TRL v1.11.0, so this command needs TRL >= 1.11.0. The tutorial's uv header installs trl[vllm] without a version pin, so it resolves to the latest release, which includes the change.

This PR was prepared with AI assistance.


Note

Low Risk
Documentation-only change to example shell commands; no runtime or training code is modified.

Overview
Updates the Wordle GRPO tutorial’s Option 2 setup so the separate vLLM server uses vLLM’s native vllm serve instead of the deprecated trl vllm-serve.

The new command sets VLLM_SERVER_DEV_MODE=1 and adds flags for NCCL weight transfer, processed_logprobs, and unlimited max logprobs so the server matches TRL’s post–v1.11.0 expectations for GRPO training against a remote vLLM instance.

Reviewed by Cursor Bugbot for commit 6236537. Bugbot is set up for automated code reviews on this repo. Configure here.

@sergiopaniego sergiopaniego changed the title [DO NOT MERGE yet] Update wordle tutorial to native vllm serve Update wordle tutorial to native vllm serve Oct 11, 2026
@sergiopaniego
sergiopaniego marked this pull request as ready for review October 11, 2026 15:26
@bot-ci-comment

Copy link
Copy Markdown

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.

@sergiopaniego
sergiopaniego merged commit 5639e52 into main Oct 14, 2026
14 checks passed
@sergiopaniego
sergiopaniego deleted the update-wordle-vllm-serve branch October 14, 2026 14:47
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.

1 participant