An error in cpu build

Site Feedback
1

There is an error in this page .
In the latest version of source code on github (v0.20.2rc0-260-ga7b801e26), the config files of cpu build locate at

  1. vllm_source/requirements/cpu.txt
  2. vllm_source/requirements/build/cpu.txt

However, the docs website says as follows:

uv pip install -r requirements/cpu-build.txt --torch-backend cpu
uv pip install -r requirements/cpu.txt --torch-backend cpu

Please correct this error on the page.
Furthermore, directly execute the 2 instructions may lead to this error of uv.

  × No solution found when resolving dependencies:
  ╰─▶ Because there is no version of setuptools==77.0.3 and you require setuptools==77.0.3, we can
      conclude that your requirements are unsatisfiable.

      hint: `setuptools` was found on https://download.pytorch.org/whl/cpu, but not at the
      requested version (setuptools==77.0.3). A compatible version may be available on a
      subsequent index (e.g., https://pypi.org/simple). By default, uv will only consider
      versions that are published on the first index that contains a given package, to avoid
      dependency confusion attacks. If all indexes are equally trusted, use `--index-strategy
      unsafe-best-match` to consider all versions from all indexes, regardless of the order in
      which they were defined.

Running the same command with --index-strategy unsafe-best-match works correctly, but it is not recommend.

2

You are correct: the current vLLM source uses requirements/cpu.txt and requirements/build/cpu.txt, not requirements/cpu-build.txt as shown in some documentation. The error with setuptools==77.0.3 occurs because uv by default only checks the first index, and the required version may not be present on the PyTorch index; using --index-strategy unsafe-best-match allows uv to resolve dependencies across all indexes and fixes the issue, as described in the docs and issues (source, source).

The documentation should be updated to reference the correct file paths and to recommend the --index-strategy unsafe-best-match flag for dependency resolution. Would you like a step-by-step breakdown of the correct installation commands and the reasoning behind the index strategy?

Sources:

Hint: Mention @RunLLM in the post for followups.