Skip to content

docs(verl): add verl training setup and launch instructions#73

Merged
lyzustc merged 2 commits into
awslabs:mainfrom
lyzustc:main
Jun 10, 2026
Merged

docs(verl): add verl training setup and launch instructions#73
lyzustc merged 2 commits into
awslabs:mainfrom
lyzustc:main

Conversation

@lyzustc

@lyzustc lyzustc commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Add verl training setup and launch instructions to official docs.

See the rendered doc page at https://lyzustc.github.io/agentcore-rl-toolkit/guides/verl-backend-setup/.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Comment thread docs/site/src/content/docs/guides/verl-backend-setup.md
uv pip install --no-deps -e verl/ --torch-backend=cu130

# Download and install the stable branch vllm (support vLLM serving in RL rollout) of agentcore-rl-toolkit
git clone https://github.com/awslabs/agentcore-rl-toolkit -b vllm

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

do we need the vllm branch?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Don't need it, will remove.

uv pip install -e rllm/rllm-model-gateway
```

:::note

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

maybe add this at the top so people don't install the wrong version but only realize until the end?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

ok, sounds good.

uv venv --python 3.12 --seed
source .venv/bin/activate

uv pip install vllm==0.21.0 --torch-backend=cu130

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

looks like v0.8.0 only verified vllm==0.20.2? https://github.com/verl-project/verl/releases/tag/v0.8.0. should we be more conservative or is there some features that we need post 0.20.2?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

My test is using vllm 0.21.0 when verl 0.8.0 is not released yet. But yeah using the official recommended vllm version is good. I will change.

## Prerequisites

- A GPU cluster with **CUDA>=12.8** installed.
- Python 3.10+ and [`uv`](https://docs.astral.sh/uv/).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@lyzustc should we raise to python 3.12? I just realized yesterday megatron-bridge (post v0.4.2) that's compatible with verl 0.8.0 actually already dropped python 3.10 support (minimum python 3.12). see release notes on the github page here https://github.com/NVIDIA-NeMo/Megatron-Bridge

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Good catch, will change it.

@lyzustc
lyzustc merged commit d92b839 into awslabs:main Jun 10, 2026
2 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.

3 participants