Quantization details
- Scheme — W4A16 — FP4 (E2M1) weights group 16 (FP8 E4M3 scale + per-tensor FP32 global scale), BF16 activations, stored as compressed-tensors
nvfp4-pack-quantized.
- Kept in BF16 — the vision tower & projector (
model.visual.*), the multi-token-prediction head (mtp.*), all RMSNorms, token embeddings, the LM head, the entire linear-attention (GatedDeltaNet/SSM) path — FP4 is too coarse for the SSM weights, so the full linear_attn.* stays BF16. Left unquantized to preserve quality (about 32% of all parameters in this build).
- Tokenizer /
chat_template / generation_config are identical to the original. config.json is the original plus a quantization_config block.
This is post-training quantization (PTQ) — no retraining. AWQ uses a small calibration set (no gradient) to protect salient weight channels before rounding.
Benchmarks (measured)
Every column was measured with the same harness and settings — lm-evaluation-harness on vLLM, greedy, few-shot completion (no chat template). Percentages are recovery vs. the BF16 original.
Table with columns: Benchmark, BF16 (original), FP8-dynamic, AWQ-8bit, NVFP4A16 (this repo), NVFP4, AWQ-4bit| Benchmark | BF16 (original) | FP8-dynamic | AWQ-8bit | NVFP4A16 (this repo) | NVFP4 | AWQ-4bit |
|---|
| MMLU (5-shot) | 86.02 | 86.01 (100.0%) | 86.05 (100.0%) | 86.07 (100.1%) | 86.01 (100.0%) | 86.08 (100.1%) |
| GSM8K (5-shot, strict) | 37.00 | 38.06 (102.9%) | 34.80 (94.1%) | 81.43 (220.1%) | 71.27 (192.6%) | 82.87 (224.0%) |
| ARC-Challenge (0-shot) | 61.18 | 61.69 (100.8%) | 61.60 (100.7%) | 60.84 (99.4%) | 60.58 (99.0%) | 60.84 (99.4%) |
| Winogrande (5-shot) | 80.43 | 80.03 (99.5%) | 80.58 (100.2%) | 79.64 (99.0%) | 79.48 (98.8%) | 80.11 (99.6%) |
| KMMLU (5-shot, direct) | 69.79 | 69.83 (100.1%) | 69.84 (100.1%) | 69.61 (99.7%) | 69.19 (99.1%) | 68.98 (98.8%) |
| HAE-RAE (0-shot) | 76.99 | 77.36 (100.5%) | 77.64 (100.8%) | 75.89 (98.6%) | 75.71 (98.3%) | 76.44 (99.3%) |
| Average | 68.57 | 68.83 (100.4%) | 68.42 (99.8%) | 75.58 (110.2%) | 73.71 (107.5%) | 75.89 (110.7%) |
| Average without GSM8K | 74.88 | 74.98 (100.1%) | 75.14 (100.4%) | 74.41 (99.4%) | 74.19 (99.1%) | 74.49 (99.5%) |
Note on GSM8K: this task is scored on free-form generation, so the score depends on whether the model answers in exactly the format the scorer expects. For this model it swings widely between builds of the same model (GSM8K 34.8–82.9), and some quantized builds score far above the BF16 original — that reflects answer-format adherence, not quantization quality. The second average leaves it out.
Evaluation (measured)
Fidelity to the BF16 original on an internal mixed English/Korean set (100 prompts, BF16 greedy answers scored under each build — same harness for every row).
Table with columns: Metric, This model, BF16 original| Metric | This model | BF16 original |
|---|
| Perplexity (lower = closer) | 1.3779 | 1.3603 (+1.3%) |
| Top-1 next-token agreement | 95.6% | 99.3% |
These measure fidelity to the base model, not absolute task scores.
Requirements
Table | |
|---|
| Runtime | vLLM — the architecture is in vLLM ≥ 0.17.0; tested here with vLLM 0.32.0. |
| vLLM install | vLLM 0.32 itself needs Python 3.11–3.14, torch 2.13 (CUDA 13.0 build, so an NVIDIA driver with CUDA 13 support), transformers ≥5.16.1,<5.20 and compressed-tensors 0.17.0 (both pinned by vLLM; 0.17.0 reads this checkpoint, which was saved with 0.19.0 — do not upgrade it separately). |
| GPU | NVIDIA Turing (sm75) or newer — weight-only FP4, no FP4 tensor cores needed. V100 (sm70) is not supported. (Kernel choice per GPU from vLLM 0.32's selection code; only B200 was run here.) |
| Memory | Weights: 28.6 GB. Add KV cache (grows with context length × concurrent requests) and a few GB for activations / CUDA graphs; use --tensor-parallel-size N when the weights do not fit one GPU. |
| Transformers (without vLLM) | transformers>=5.2.0 + compressed-tensors>=0.15.0 (checked on CPU with Qwen3.5-0.8B FP8 / AWQ-4bit / NVFP4A16 / NVFP4). |
| trust_remote_code | not needed |
Usage (vLLM)
Start an OpenAI-compatible server:
vllm serve axteam/Qwen3.5-27B-NVFP4A16 --max-model-len 32768
Query it:
curl http://localhost:8000/v1/chat/completions -H "Content-Type: application/json" -d '{ "model": "axteam/Qwen3.5-27B-NVFP4A16", "messages": [{"role": "user", "content": "대한민국의 수도는 어디인가요?"}], "temperature": 0.6, "top_p": 0.95, "top_k": 20, "max_tokens": 512}'
Offline inference in Python:
from vllm import LLM, SamplingParams llm = LLM(model="axteam/Qwen3.5-27B-NVFP4A16", max_model_len=32768)params = SamplingParams(temperature=0.6, top_p=0.95, top_k=20, max_tokens=1024)out = llm.chat([{"role": "user", "content": "Explain model quantization in two sentences."}], params)print(out[0].outputs[0].text) # image input (URL or data: URI)messages = [{"role": "user", "content": [ {"type": "image_url", "image_url": {"url": "https://example.com/your-image.png"}}, {"type": "text", "text": "Describe this image."},]}]out = llm.chat(messages, params)print(out[0].outputs[0].text)
Recommended sampling (from the original generation_config.json): temperature=0.6, top_p=0.95, top_k=20.
Thinking mode is on by default in the chat template; to turn it off pass chat_template_kwargs={"enable_thinking": False} (Python llm.chat(..., chat_template_kwargs=...), or "chat_template_kwargs": {"enable_thinking": false} in the request body).
Text-only serving: add --limit-mm-per-prompt '{"image": 0, "video": 0}' to skip loading the vision encoder's memory budget.
Reducing KV-cache memory (optional, serve-time)
The KV cache is kept in BF16 by default. KV-cache precision is a runtime choice, independent of the
weight quantization above; for long contexts or large batches FP8 roughly halves KV-cache memory:
vllm serve axteam/Qwen3.5-27B-NVFP4A16 --kv-cache-dtype fp8
License
Quantized derivative of Qwen/Qwen3.5-27B (Apache-2.0). All original weights, tokenizer and chat template belong to the Qwen team.
한국어 요약
Qwen/Qwen3.5-27B의 NVFP4A16 (W4A16) 양자화 빌드 · 제작 axteam
개요
Table with columns: 항목, 내용| 항목 | 내용 |
|---|
| 원본 모델 | Qwen/Qwen3.5-27B |
| 양자화 방식 | NVFP4A16 (W4A16, FP4 가중치) |
| 저장 형식 | compressed-tensors nvfp4-pack-quantized |
| 모델 구조 | 하이브리드 어텐션(선형 어텐션 + 풀 어텐션) · Dense · 멀티모달(비전) · MTP 헤드 |
| 용량 | 약 28.6 GB |
| 보정 데이터 | 샘플 256개 (한국어 위주 혼합 코퍼스) |
양자화 상세
- 가중치: FP4(E2M1), 그룹 크기 16 (그룹별 FP8(E4M3) 스케일 + 텐서별 FP32 전역 스케일)
- 활성화: BF16 (양자화하지 않음)
- 양자화 절차: PTQ(학습 후 양자화, 재학습 없음), AWQ 방식 — 보정 데이터로 활성화가 큰 가중치 채널을 찾아 채널별 스케일로 보호한 뒤 FP4로 반올림
- BF16 유지: 비전 타워·투영층(
model.visual.*), MTP 헤드(mtp.*), 모든 RMSNorm, 토큰 임베딩, LM 헤드, 선형 어텐션(GatedDeltaNet/SSM) 경로 전체(linear_attn.*, FP4로는 정밀도 부족) — 전체 파라미터의 약 32%
- 원본 파일: 토크나이저·chat template·generation config는 원본과 동일,
config.json은 원본에 quantization_config 블록만 추가
품질 (실측)
- 원본 대비 충실도: PPL 1.3779 (원본 1.3603, +1.3%, 낮을수록 원본에 가까움), 다음 토큰 top-1 일치율 95.6% (원본 자체 기준값 99.3%) — 내부 영어·한국어 혼합 프롬프트 100개, 원본(BF16)의 greedy 답변을 기준 텍스트로 측정
- 벤치마크 평균: 75.58 (원본 68.57, 110.2%) — MMLU·GSM8K·ARC-Challenge·Winogrande·KMMLU·HAE-RAE 6종 평균, lm-evaluation-harness + vLLM, chat template 없는 few-shot·greedy, 모든 빌드를 같은 설정으로 측정
- GSM8K 제외 평균: 74.41 (원본 74.88, 99.4%) — GSM8K는 자유 생성 답을 채점기가 기대하는 형식 그대로 썼을 때만 점수가 나서, 이 모델에서는 같은 모델의 빌드끼리도 값이 크게 흔들리고 일부 양자화 빌드가 원본보다 훨씬 높게 나옴 (답 형식 준수 차이이지 양자화 품질 차이가 아님)
- 한국어 벤치마크: KMMLU 69.61 (원본 69.79, 99.7%) · HAE-RAE 75.89 (원본 76.99, 98.6%)
요구사항
- 실행 엔진: vLLM 0.17.0 이상(이 구조를 지원하는 첫 버전), 이 빌드는 vLLM 0.32.0에서 실행 확인
- vLLM 0.32 설치 조건: Python 3.11~3.14, torch 2.13(CUDA 13.0 빌드, CUDA 13 지원 드라이버 필요), transformers 5.16.1 이상 5.20 미만, compressed-tensors 0.17.0 — transformers·compressed-tensors는 vLLM이 버전을 고정하므로 compressed-tensors를 따로 업그레이드하지 말 것 (이 체크포인트는 0.19.0으로 저장됐지만 0.17.0에서도 로드됨)
- GPU: NVIDIA Turing(sm75) 이상, V100(sm70) 미지원 — 가중치 전용 FP4라 FP4 전용 텐서코어 불필요 (GPU별 지원 여부는 vLLM 0.32 커널 선택 코드 기준, 실제 실행은 B200에서만 확인)
- 메모리: 가중치 28.6 GB + KV 캐시(컨텍스트 길이 × 동시 요청 수에 비례) + 활성화·CUDA graph용 수 GB — GPU 한 장에 다 들어가지 않으면
--tensor-parallel-size N으로 분산
- Transformers로 직접 사용: transformers 5.2.0 이상 + compressed-tensors 0.15.0 이상 (Qwen3.5-0.8B의 FP8·AWQ-4bit·NVFP4A16·NVFP4 빌드로 CPU에서 확인)
- trust_remote_code: 불필요
사용법
- 서버 실행:
vllm serve axteam/Qwen3.5-27B-NVFP4A16 --max-model-len 32768 — OpenAI 호환 API
- Python:
LLM(model="axteam/Qwen3.5-27B-NVFP4A16", max_model_len=32768).chat(...) — 전체 예시는 위 영어 본문 'Usage (vLLM)' 절 참고
- 권장 샘플링:
temperature=0.6, top_p=0.95, top_k=20 (원본 generation_config.json 기준)
- thinking 모드: 기본 켜짐 — 끄려면
chat_template_kwargs={"enable_thinking": False} 전달(Python은 llm.chat() 인자, HTTP는 요청 본문의 "chat_template_kwargs": {"enable_thinking": false})
- 이미지 입력: 메시지에
image_url 항목 사용
- 텍스트만 사용할 때:
--limit-mm-per-prompt '{"image": 0, "video": 0}' — 비전 타워용 메모리 예약을 생략해 메모리 절약
- KV 캐시 절감(선택):
vllm serve에 --kv-cache-dtype fp8 추가 — 기본 BF16인 KV 캐시를 FP8로 저장해 KV 캐시 메모리를 약 절반으로 줄임 (긴 컨텍스트·동시 요청이 많을 때 유리, 가중치 양자화와 별개인 실행 옵션)
참고
- 수정 이력 (2026-11-01): AWQ가 스무딩하지 않는 RMSNorm 가중치를 원본과 비트 단위로 같게 복원 — llm-compressor가 남긴 BF16 반올림 오차(실효 가중치 기준 최대 0.4%) 제거, 양자화 가중치와 AWQ로 스무딩된 RMSNorm은 변경 없음, 품질 항목의 벤치마크는 복원 후, 충실도는 복원 전 기준
라이선스
- 라이선스: Apache-2.0 — 원본 모델의 라이선스를 그대로 따름
- 권리: 원본 가중치·토크나이저·chat template은 Qwen 팀(Alibaba) 소유, 이 리포는 양자화 파생물