Skip to content

Commit e045543

Browse files
shahfasaldevpatelio
authored andcommitted
[Doc] Fix macOS installation dependency resolution issue (vllm-project#26721)
Signed-off-by: faisal shah <[email protected]>
1 parent 9526807 commit e045543

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

docs/getting_started/installation/cpu.apple.inc.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,15 @@ After installation of XCode and the Command Line Tools, which include Apple Clan
2828
```bash
2929
git clone https://github.com/vllm-project/vllm.git
3030
cd vllm
31-
uv pip install -r requirements/cpu.txt
31+
uv pip install -r requirements/cpu.txt --index-strategy unsafe-best-match
3232
uv pip install -e .
3333
```
3434

35+
!!! tip
36+
The `--index-strategy unsafe-best-match` flag is needed to resolve dependencies across multiple package indexes (PyTorch CPU index and PyPI). Without this flag, you may encounter `typing-extensions` version conflicts.
37+
38+
The term "unsafe" refers to the package resolution strategy, not security. By default, `uv` only searches the first index where a package is found to prevent dependency confusion attacks. This flag allows `uv` to search all configured indexes to find the best compatible versions. Since both PyTorch and PyPI are trusted package sources, using this strategy is safe and appropriate for vLLM installation.
39+
3540
!!! note
3641
On macOS the `VLLM_TARGET_DEVICE` is automatically set to `cpu`, which is currently the only supported device.
3742

0 commit comments

Comments
 (0)