llm-compressor 支持

March 18, 2026 · View on GitHub

本指南旨在介绍如何使用 LMDeploy 的 TurboMind 推理引擎,运行经由 vllm-project/llm-compressor工具量化后的模型。 目前支持的 llm-compressor 量化模型包括:

  • int4 量化(例如 AWQ、GPTQ)

上述量化模型通过 TurboMind 引擎可以在以下 NVIDIA GPU 架构上运行:

Compute CapabilityMicro-architectureGPUs
7.0VoltaV100
7.2VoltaJetson Xavier
7.5TuringGeForce RTX 20 series, T4
8.0AmpereA100, A800, A30
8.6AmpereGeForce RTX 30 series, A40, A10
8.7AmpereJetson Orin
8.9Ada LovelaceGeForce RTX 40 series, L40, L20
9.0HopperH20, H200, H100, GH200
12.0BlackwellGeForce RTX 50 series

LMDeploy 将持续跟进并扩展对 llm-compressor 项目的支持。

本文的其余部分由以下章节组成:

模型量化

llm-compressor 提供了丰富的模型量化用例,请参考其教程选择 LMDeploy 支持的量化算法,完成模型量化工作。 LMDeploy 也内置了通过 llm-compressor 对 Qwen3-30B-A3B 进行 AWQ 量化的脚本,供大家进行参考:

# 创建 conda 环境
conda create -n lmdeploy python=3.10 -y
conda activate lmdeploy

# 安装 llm-compressor
pip install llmcompressor

# 下载 lmdeploy 源码,运行量化用用例
git clone https://github.com/InternLM/lmdeploy
cd lmdeploy
python examples/lite/qwen3_30b_a3b_awq.py --work-dir ./qwen3_30b_a3b_awq

在接下来的章节中,我们以此量化模型为例,介绍模型部署、评测精度等方法

模型部署

离线推理

量化后的模型,通过以下几行简单的代码,可以实现离线批处理:

from lmdeploy import pipeline, TurbomindEngineConfig
engine_config = TurbomindEngineConfig()
with pipeline("./qwen3_30b_a3b_4bit", backend_config=engine_config) as pipe:
    response = pipe(["Hi, pls intro yourself", "Shanghai is"])
    print(response)

关于 pipeline 的详细介绍,请参考这里

在线服务

LMDeploy api_server 支持把模型一键封装为服务,对外提供的 RESTful API 兼容 openai 的接口。以下为服务启动的示例:

lmdeploy serve api_server ./qwen3_30b_a3b_4bit --backend turbomind

服务默认端口是23333。在 server 启动后,你可以通过 openai SDK 访问服务。关于服务的命令参数,以及访问服务的方式,可以阅读这份文档

精度评测

我们将 Qwen3-8B (Dense) 与 Qwen3-30B-A3B (MoE) 的 AWQ 对称/非对称量化模型通过 LMDeploy 部署为服务,并使用 opencompass 在多个学术数据集上评测。结果显示:Qwen3-8B 的非对称量化整体优于对称量化,而 Qwen3-30B-A3B 在两种量化方式间差异不显著;Qwen3-8B 在对称/非对称量化下与 BF16 模型的精度差异小于 Qwen3-30B-A3B。与 BF16 相比,量化模型在长输出数据集,比如 aime2025 (平均 17,635 tokens)、LCB (平均 14,157 tokens),精度下降更明显;在中短输出数据集,比如 ifeval (平均 1,885 tokens),mmlu_pro (平均 2,826),精度符合预期。

datasetQwen3-8BQwen3-30B-A3B
bf16awq symawq asymbf16awq symawq asym
ifeval85.5883.7385.7786.3284.1084.29
hle5.055.055.247.005.475.65
gpqa59.9756.5759.4761.7457.9557.07
aime202569.4864.3863.9673.4464.7966.67
mmlu_pro73.6971.7372.3477.8575.7775.69
LCBCodeGeneration50.8644.1046.9556.6750.8649.24

复现方式可以参考这份文档