Issue Station
Sign In
Tools hereToolbox

vllm - ✅(Solved) Fix [Doc]: no such option: --index-strategy at pip install vllm [1 pull requests]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

PR fix notes

PR #39467: [Doc] Add pip equivalent for CUDA-specific wheel installation

Description (problem / solution / changelog)

Summary

The "specific CUDA version" install section (gpu.cuda.inc.md) only showed a uv pip install command with no pip alternative. The default install section above it already has a ??? console "pip" collapsible block this PR adds the same for the CUDA-specific section, for consistency.

Root cause context

Issue #39462 reports that the vllm.ai quickstart widget generates pip install ... --index-strategy unsafe-best-match for non-default CUDA versions, but --index-strategy is a uv-only flag. The actual bug is in the website's JavaScript (the Stable + non-default CUDA path appends this flag unconditionally to both uv and pip commands). The vllm docs are technically correct, but were missing a pip equivalent for this specific section.

Changes

  • Added ??? console "pip" collapsible block for the CUDA-specific wheel install section, matching the existing pattern used in the default install section above

Testing

Documentation-only change. No code changes.

Relates to #39462

Changed files

  • docs/getting_started/installation/gpu.cuda.inc.md (modified, +9/-0)

Code Example

(.venv) $ pip install vllm --extra-index-url https://wheels.vllm.ai/0.19.0/cu130 --extra-index-url https://download.pytorch.org/whl/cu130 --index-strategy unsafe-best-match

Usage:
  pip install [options] <requirement specifier> [package-index-options] ...
  pip install [options] -r <requirements file> [package-index-options] ...
  pip install [options] [-e] <vcs project url> ...
  pip install [options] [-e] <local project path> ...
  pip install [options] <archive url/path> ...

no such option: --index-strategy
RAW_BUFFERClick to expand / collapse

📚 The doc issue

I looked at Quickstart and executed the command. https://vllm.ai/

There is no option called --index-strategy in Python3.12. I looked for an option with a similar name starting with index, but it doesn't seem to be there.

Which option should I specify? By the way, Do you support CUDA 13.1 and 13.2?

(.venv) $ pip install vllm --extra-index-url https://wheels.vllm.ai/0.19.0/cu130 --extra-index-url https://download.pytorch.org/whl/cu130 --index-strategy unsafe-best-match

Usage:
  pip install [options] <requirement specifier> [package-index-options] ...
  pip install [options] -r <requirements file> [package-index-options] ...
  pip install [options] [-e] <vcs project url> ...
  pip install [options] [-e] <local project path> ...
  pip install [options] <archive url/path> ...

no such option: --index-strategy

Suggest a potential alternative/fix

I can't think of an alternative, but I think the only way is to make pip install vllm without options with CUDA 13.1 and 13.2.

Before submitting a new issue...

  • Make sure you already searched for relevant issues, and asked the chatbot living at the bottom right corner of the documentation page, which can answer lots of frequently asked questions.

extent analysis

TL;DR

The issue can be resolved by removing the --index-strategy option from the pip install command.

Guidance

  • Remove the --index-strategy option from the command, as it is not a valid option for pip in Python 3.12.
  • Verify the available options for pip by running pip install --help.
  • Check the documentation for vllm to see if there are any specific installation instructions for CUDA 13.1 and 13.2.
  • Consider installing vllm without specifying the --index-strategy option and see if it installs correctly.

Notes

The --index-strategy option is not a standard option for pip, and its removal should allow the installation to proceed. However, the success of the installation may depend on other factors, such as the availability of compatible packages for CUDA 13.1 and 13.2.

Recommendation

Apply workaround: Remove the --index-strategy option from the command, as it is not a valid option for pip in Python 3.12. This should allow the installation to proceed, but may require additional troubleshooting to ensure compatibility with CUDA 13.1 and 13.2.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#logging issue#authentication issue#prompt issue#agent setup#task chaining

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING