Skip to content

[Misc] Move pyav and soundfile to common requirements#39997

Merged
vllm-bot merged 2 commits into
vllm-project:mainfrom
Isotr0py:mv-pyav
Apr 16, 2026
Merged

[Misc] Move pyav and soundfile to common requirements#39997
vllm-bot merged 2 commits into
vllm-project:mainfrom
Isotr0py:mv-pyav

Conversation

@Isotr0py
Copy link
Copy Markdown
Member

@Isotr0py Isotr0py commented Apr 16, 2026

Purpose

  • Move pyav and soundfile out of vllm[audio], then audio extra deps will only keep model-specific packages like scipy (phi4-mm) and mistral-common[audio] (voxtral, will introdce soxr with LGPL license)
  • Most of audio models can work without installing extra audio dependency introudced LGPL license.

Test Plan

Test Result


Essential Elements of an Effective PR Description Checklist
  • The purpose of the PR, such as "Fix some issue (link existing issues this PR will resolve)".
  • The test plan, such as providing test command.
  • The test results, such as pasting the results comparison before and after, or e2e results
  • (Optional) The necessary documentation update, such as updating supported_models.md and examples for a new model.

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
@Isotr0py Isotr0py requested a review from DarkLight1337 April 16, 2026 10:04
@mergify mergify Bot added the ci/build label Apr 16, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request moves the av and soundfile libraries from optional extras to the core requirements in common.txt. Feedback indicates that making these dependencies mandatory introduces heavy system-level requirements (FFmpeg and libsndfile) and LGPL-licensed code into the base installation, which increases the footprint for text-only users and contradicts the goal of isolating such dependencies. Additionally, the new requirements are unversioned, posing a risk to build stability.

Comment thread requirements/common.txt
msgspec
gguf >= 0.17.0
mistral_common[image] >= 1.11.0
av # required for audio in video IO
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.

high

Moving av (PyAV) to common requirements introduces a mandatory dependency on FFmpeg, which is a heavy system-level requirement and is typically LGPL/GPL licensed. This significantly increases the installation footprint and the potential for installation failures in minimal environments (e.g., base Docker images) for users who only require text-based inference. Furthermore, this change contradicts the PR's stated goal of isolating LGPL dependencies, as it moves an LGPL-linked library from an optional extra into the core requirements. This should remain in an optional extra like [video] or [audio]. Additionally, the requirement is unversioned here, which can lead to non-deterministic builds.

Comment thread requirements/common.txt
mistral_common[image] >= 1.11.0
av # required for audio in video IO
opencv-python-headless >= 4.13.0 # required for video IO
soundfile # required for audio IO
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.

high

Moving soundfile to common requirements forces a mandatory dependency on the libsndfile system library (LGPL) for all vLLM users. This introduces unnecessary system-level overhead for text-only use cases and, similar to the av dependency, contradicts the objective of keeping the base installation free of LGPL-linked libraries. It is recommended to keep this dependency within the [audio] extra to maintain modularity and a lightweight core. This requirement is also unversioned, which is a risk for build stability.

@DarkLight1337 DarkLight1337 enabled auto-merge (squash) April 16, 2026 10:06
@DarkLight1337 DarkLight1337 requested a review from ywang96 April 16, 2026 10:06
@github-actions github-actions Bot added the ready ONLY add when PR is ready to merge/full CI is needed label Apr 16, 2026
Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
@vllm-bot vllm-bot merged commit 617d1c2 into vllm-project:main Apr 16, 2026
5 of 8 checks passed
@Isotr0py Isotr0py deleted the mv-pyav branch April 16, 2026 15:52
Isotr0py added a commit that referenced this pull request Apr 19, 2026
bnellnm pushed a commit to neuralmagic/vllm that referenced this pull request Apr 20, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
baonudesifeizhai pushed a commit to baonudesifeizhai/vllm that referenced this pull request Apr 23, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
whk-lab pushed a commit to whk-lab/vllm that referenced this pull request Apr 23, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
avinashsingh77 pushed a commit to avinashsingh77/vllm that referenced this pull request Apr 27, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
Signed-off-by: Avinash Singh <avinashsingh.rcoem@gmail.com>
mystous pushed a commit to mystous/vllm_hybrid that referenced this pull request May 10, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
my-other-github-account pushed a commit to my-other-github-account/vllm that referenced this pull request May 15, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
my-other-github-account pushed a commit to my-other-github-account/vllm that referenced this pull request May 15, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
jhu960213 pushed a commit to jhu960213/vllm that referenced this pull request May 20, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
Rukhaiya2004 pushed a commit to Rukhaiya2004/vllm that referenced this pull request May 23, 2026
…ct#39997)

Signed-off-by: Isotr0py <mozf@mail2.sysu.edu.cn>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci/build ready ONLY add when PR is ready to merge/full CI is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants