Skip to content

Add user guide for v2v and transfer for vllm-omni#247

Merged
rickzw merged 9 commits into
NVIDIA:mainfrom
bastefaniak:bstefaniak/mbala_vllm_omni_transfer
Jul 22, 2026
Merged

Add user guide for v2v and transfer for vllm-omni#247
rickzw merged 9 commits into
NVIDIA:mainfrom
bastefaniak:bstefaniak/mbala_vllm_omni_transfer

Conversation

@bastefaniak

Copy link
Copy Markdown
Contributor

This is a rebased copy of PR, as original contributor is OOO.

This PR adds user guide for v2v and transfer generation for vllm-omni. It uses the already merged transfer examples. The PR depends on this PR for vllm-omni: vllm-project/vllm-omni#4379, it should be merged after it.

MaciejBalaNV and others added 4 commits June 16, 2026 14:51
Signed-off-by: Maciej Bala <mbala@nvidia.com>
Signed-off-by: Maciej Bala <mbala@nvidia.com>
Signed-off-by: Maciej Bala <mbala@nvidia.com>
@bastefaniak

Copy link
Copy Markdown
Contributor Author

@trungtpham @lfengad Could you please look?

Comment thread cookbooks/cosmos3/generator/transfer/README.md
@trungtpham

Copy link
Copy Markdown
Collaborator

The MR looks good to me.
However, it seems I don't have privilege to approve the MR.
@qmiao-hub helps approve the MR. Thanks

@qmiao-hub
qmiao-hub self-requested a review June 30, 2026 18:00
@qmiao-hub

Copy link
Copy Markdown
Collaborator

@trungtpham - to confirm we will not have a separate notebook as run_with_vllm-omni ( along with PyTorch)?

@trungtpham

Copy link
Copy Markdown
Collaborator

@trungtpham - to confirm we will not have a separate notebook as run_with_vllm-omni ( along with PyTorch)?

The MR adds [run_video_transfer_with_vllm_omni.ipynb]. Is this the one you are talking about?

@qmiao-hub

Copy link
Copy Markdown
Collaborator

@trungtpham - ok saw that, looks good I will approve this PR, thank you!

@lishunyang12

Copy link
Copy Markdown
Contributor

@lfengad Can you help approve this MR? Thanks :)

@lfengad

lfengad commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

@bastefaniak @lishunyang12 Some conflicts might be resolved? After that we could merge. THX!

@lishunyang12

lishunyang12 commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

@bastefaniak @MaciejBalaNV. And I have a few comments below, then it is good to go. Thanks!


Set up the environment and start the server:
[vLLM-Omni setup](../../README.md#vllm-omni). Transfer controls require the
native vLLM-Omni install from `main` until the `vllm/vllm-omni:v0.23.0` Docker

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.

We are about to release the Docker image for 0.24.0, as we only release Docker images for even-numbered versions.

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.

Updated to point to vllm/vllm-omni:v0.24.0

Comment thread README.md Outdated
Use vLLM-Omni for Generator production inference behind an OpenAI-compatible API. This integration loads the full Cosmos 3 checkpoint, including the Qwen3-VL-based reasoner path and the diffusion generation path. For understanding-only tasks that return text, use [Reasoner with vLLM](#reasoner-with-vllm) instead, which loads only the reasoner.

> **Compatibility status:** Cosmos 3 Generator support has landed in [vllm-project/vllm-omni](https://github.com/vllm-project/vllm-omni) `main`: text-to-image, text-to-video, and image-to-video ([#3454](https://github.com/vllm-project/vllm-omni/pull/3454)) and video-with-sound ([#4073](https://github.com/vllm-project/vllm-omni/pull/4073)) are merged; action (policy / forward-dynamics) is in review ([#4102](https://github.com/vllm-project/vllm-omni/pull/4102)) and video-to-video is planned. The `vllm/vllm-omni:cosmos3` Docker image remains the easiest all-in-one build. For current setup and per-modality usage, see the maintained recipes: [Cosmos3-Nano](https://github.com/vllm-project/vllm-omni/blob/main/recipes/cosmos3/Cosmos3-Nano.md) and [Cosmos3-Super](https://github.com/vllm-project/vllm-omni/blob/main/recipes/cosmos3/Cosmos3-Super.md).
> **Compatibility status:** Cosmos 3 Generator support is available in [vllm-project/vllm-omni](https://github.com/vllm-project/vllm-omni) `main` for text-to-image, text-to-video, image-to-video, video-to-video, transfer-control video-to-video, video-with-sound, and action generation. Transfer-control video-to-video requires installing vLLM-Omni from `main` until the `vllm/vllm-omni:v0.23.0` Docker image is released. For current setup and per-modality usage, see the maintained recipes: [Cosmos3-Nano](https://github.com/vllm-project/vllm-omni/blob/main/recipes/cosmos3/Cosmos3-Nano.md) and [Cosmos3-Super](https://github.com/vllm-project/vllm-omni/blob/main/recipes/cosmos3/Cosmos3-Super.md).

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.

Same as above. We can wait until 0.24.0 docker image is officially released in next couple of days.

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, I'll resolve conflicts once new vllm-omni image drops

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.

Ok, I'll resolve conflicts once new vllm-omni image drops

Now, image is available. Please proceed.

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.

Updated to point to vllm/vllm-omni:v0.24.0

Comment thread cookbooks/cosmos3/README.md Outdated
(including action). Pull once:
The prebuilt image `vllm/vllm-omni:cosmos3` supports the released Generator
modalities. Transfer controls require the native vLLM-Omni install from `main`
until the `vllm/vllm-omni:v0.23.0` Docker image is released. Pull once:

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.

Same.

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.

Updated to point to vllm/vllm-omni:v0.24.0

"\n",
"Start a vLLM-Omni Cosmos3 server before running the request cells. The examples assume the `cosmos` repo is mounted at `/workspace` and the server runs from that directory inside the container, so repo-local `cookbooks/...` paths resolve correctly.\n",
"\n",
"Transfer controls require installing vLLM-Omni from `main` until the `vllm/vllm-omni:v0.23.0` Docker image is released. Use the Docker command below only with a vLLM-Omni image that includes transfer support.\n",

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.

same

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.

Updated to point to vllm/vllm-omni:v0.24.0

@lishunyang12

Copy link
Copy Markdown
Contributor

@lfengad Can you take another look?

@qmiao-hub
qmiao-hub requested review from rickzw and yaoxu-crypto and removed request for lishunyang12 July 17, 2026 23:04

@lishunyang12 lishunyang12 left a comment

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.

LGTM

@MaciejBalaNV

Copy link
Copy Markdown
Contributor

@trungtpham @lfengad Could you please take a look?

@trungtpham

Copy link
Copy Markdown
Collaborator

LGTM.

@trungtpham trungtpham left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

# Conflicts:
#	cookbooks/cosmos3/generator/audiovisual/README.md
#	cookbooks/cosmos3/generator/audiovisual/run_with_vllm_omni.ipynb
Signed-off-by: Maciej Bala <mbala@nvidia.com>
Signed-off-by: Maciej Bala <mbala@nvidia.com>
@MaciejBalaNV

Copy link
Copy Markdown
Contributor

@trungtpham I fixed the conflicts, please approve again if possible

@lishunyang12

Copy link
Copy Markdown
Contributor

@MaciejBalaNV I might need another one with write access to approve :)

@lishunyang12

Copy link
Copy Markdown
Contributor

@rickzw Thanks for your approval. Can you safely merge this MR now?

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.

7 participants