Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Doc] Dockerfile instructions for optional dependencies and dev transformers #13699

Merged
merged 6 commits into from
Feb 22, 2025

Conversation

DarkLight1337
Copy link
Member

@DarkLight1337 DarkLight1337 commented Feb 22, 2025

FIX #12980
FIX #13675

…formers

Signed-off-by: DarkLight1337 <tlleungac@connect.ust.hk>
@DarkLight1337 DarkLight1337 added the ready ONLY add when PR is ready to merge/full CI is needed label Feb 22, 2025
Copy link

👋 Hi! Thank you for contributing to the vLLM project.

💬 Join our developer Slack at https://slack.vllm.ai to discuss your PR in #pr-reviews, coordinate on features in #feat- channels, or join special interest groups in #sig- channels.

Just a reminder: PRs would not trigger full CI run by default. Instead, it would only run fastcheck CI which starts running only a small and essential subset of CI tests to quickly catch errors. You can run other CI tests on top of those by going to your fastcheck build on Buildkite UI (linked in the PR checks section) and unblock them. If you do not have permission to unblock, ping simon-mo or khluu to add you in our Buildkite org.

Once the PR is approved and ready to go, your PR reviewer(s) can run CI to test the changes comprehensively before merging.

To run CI, PR reviewers can either: Add ready label to the PR or enable auto-merge.

🚀

@mergify mergify bot added the documentation Improvements or additions to documentation label Feb 22, 2025
Signed-off-by: DarkLight1337 <tlleungac@connect.ust.hk>
```Dockerfile
FROM vllm/vllm-openai:latest

RUN uv pip install --system vllm[audio,video]
Copy link
Member

Choose a reason for hiding this comment

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

this will install public latest released vllm, right? what if people build their own docker on a custom commit, and then just want to install these additional dependencies?

Copy link
Member Author

Choose a reason for hiding this comment

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

Yes, that is correct. It is just an example, I'll add a comment telling users that they can change the base image as necessary.

Copy link
Member Author

Choose a reason for hiding this comment

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

Done in 0970da6

Copy link
Member

Choose a reason for hiding this comment

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

FROM vllm/vllm-openai:latest

you can change the base image here. but even if you change the base image,

RUN uv pip install --system vllm[audio,video]

this line will install the latest released version, it will not keep the current vllm in the docker.

Copy link
Member Author

Choose a reason for hiding this comment

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

Oh, I see what you mean now... hmm, how can we only install the extras without the main package?

Copy link
Member

Choose a reason for hiding this comment

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

Which license is it that's problematic? If we could find an alternative then we can package everything in the container

Copy link
Member Author

@DarkLight1337 DarkLight1337 Feb 22, 2025

Choose a reason for hiding this comment

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

Which license is it that's problematic? If we could find an alternative then we can package everything in the container

See #8030

Copy link
Member Author

Choose a reason for hiding this comment

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

I don't know either. maybe just add comment to explicitly mention this limitation?

Is the vLLM directory inside the Docker container? Perhaps we can pip install from it?

Copy link
Member

Choose a reason for hiding this comment

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

I don't think it has the vllm directory. vllm/vllm-openai is for deployment, and vllm is installed as a pip package.

Copy link
Member Author

@DarkLight1337 DarkLight1337 Feb 22, 2025

Choose a reason for hiding this comment

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

Alright, to keep things simple I have included a specific version of vLLM in the example.

Signed-off-by: DarkLight1337 <tlleungac@connect.ust.hk>
Signed-off-by: DarkLight1337 <tlleungac@connect.ust.hk>
Signed-off-by: DarkLight1337 <tlleungac@connect.ust.hk>
Signed-off-by: DarkLight1337 <tlleungac@connect.ust.hk>
Copy link
Member

@youkaichao youkaichao left a comment

Choose a reason for hiding this comment

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

LGTM now

@DarkLight1337 DarkLight1337 enabled auto-merge (squash) February 22, 2025 13:22
@simon-mo simon-mo merged commit 8354f66 into vllm-project:main Feb 22, 2025
14 of 15 checks passed
@DarkLight1337 DarkLight1337 deleted the dockerfile-variants branch February 22, 2025 14:04
lk-chen pushed a commit to lk-chen/vllm that referenced this pull request Mar 5, 2025
…formers (vllm-project#13699)

Signed-off-by: Linkun Chen <github@lkchen.net>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation ready ONLY add when PR is ready to merge/full CI is needed
Projects
None yet
4 participants