slavikz commited on
Commit
8a59276
·
verified ·
1 Parent(s): d484e9d

vllm_patches: rename PATCH_README.md → README.md (delete step)

Browse files
Files changed (1) hide show
  1. vllm_patches/PATCH_README.md +0 -59
vllm_patches/PATCH_README.md DELETED
@@ -1,59 +0,0 @@
1
- # vLLM patches for the `fp8-head` branch
2
-
3
- This folder contains the local vLLM overlay used to serve the
4
- `fp8-head` branch of
5
- [`inferRouter/Qwen3.6-35B-A3B-NVFP4`](https://huggingface.co/inferRouter/Qwen3.6-35B-A3B-NVFP4)
6
- when the installed vLLM build does not yet include compressed-tensors FP8
7
- `lm_head` dispatch.
8
-
9
- The `main` branch does not need this overlay because its `lm_head` and
10
- `embed_tokens` are BF16. This 35 B repository intentionally does not ship
11
- an FP8-embedding branch.
12
-
13
- | File | Purpose |
14
- |---|---|
15
- | `apply_ct_fp8_lmhead_patch.py` | Idempotent patcher for a vLLM source tree or installed package. Adds the compressed-tensors dispatch needed for FP8 `lm_head`, keeps the scale companion loader working, and skips patch points that are already present upstream. |
16
- | `compressed_tensors_embedding.py` | Companion module shared with the broader CT-FP8 patch bundle. It implements the FP8 embedding experiment, but no FP8-embedding artifact is published in this 35 B repo. |
17
- | `Dockerfile.turboquant` | Example overlay Dockerfile on top of a base image that already includes TurboQuant hybrid support (vLLM PR #39931) and upstream FP8 lm_head work. |
18
-
19
- ## Quick Start
20
-
21
- Patch an installed vLLM package:
22
-
23
- ```bash
24
- curl -O https://huggingface.co/inferRouter/Qwen3.6-35B-A3B-NVFP4/resolve/main/vllm_patches/apply_ct_fp8_lmhead_patch.py
25
- curl -O https://huggingface.co/inferRouter/Qwen3.6-35B-A3B-NVFP4/resolve/main/vllm_patches/compressed_tensors_embedding.py
26
-
27
- python3 apply_ct_fp8_lmhead_patch.py /usr/local/lib/python3.12/site-packages
28
- ```
29
-
30
- Or patch a source checkout:
31
-
32
- ```bash
33
- git clone --depth 1 --branch v0.20.2 https://github.com/vllm-project/vllm.git vllm-src
34
- python3 apply_ct_fp8_lmhead_patch.py ./vllm-src
35
- ```
36
-
37
- For `--kv-cache-dtype turboquant_4bit_nc`, the base vLLM build must also
38
- include TurboQuant hybrid attention support, merged in vLLM PR #39931.
39
- Without that PR, serve with `--kv-cache-dtype fp8_e4m3`.
40
-
41
- The patcher is idempotent. It detects PR #41000-style `lm_head` wire-up
42
- and skips already-applied edits, so it works against both stock v0.20.x
43
- trees and newer images that already include part of the upstream FP8 work.
44
-
45
- ## Expected Startup Signal
46
-
47
- When the patch is active and the `fp8-head` branch is loaded, the vLLM log
48
- should contain a compressed-tensors FP8 kernel selection similar to:
49
-
50
- ```text
51
- Selected CutlassFp8BlockScaledMMKernel for CompressedTensorsW8A8Fp8
52
- ```
53
-
54
- For the `main` branch, this line is not expected because `lm_head` is BF16.
55
-
56
- ## License
57
-
58
- The patcher and companion module are released under Apache 2.0, the same
59
- license as this repository.