zhihu/ZhiLight

ZhiLight

✨ ZhiLight ✨is a highly optimized LLM inference engine developed by Zhihu and ModelBest Inc. The "Zhi" in its name stands for Zhihu. ZhiLight can accelerate the inference of models like Llama and its variants, especially on PCIe-based GPUs. Compared to mainstream open-source inference engines, for example, vllm, it has significant performance advantages.

News 🔥

• [2025/05] Support DeepSeek-V3/DeepSeek-R1 FP8 block-quantized model.
• [2025/02] Support DeepSeek-V3/DeepSeek-R1 AWQ/GPTQ quantized model.
• [2025/01] Support DeepSeek-VL2 multimodal models: deepseek-vl2-tiny, deepseek-vl2-small, deepseek-vl2.
• [2025/01] Support LLaMA3 models: Llama-3.1-8B, Llama-3.1-70B, Llama-3.2-1B, Llama-3.2-3B, Llama-3.3-70B.

Roadmap

see Roadmap

🎉🎉 Main Features

• Asynchronous OpenAI compatible interface adapted from vllm
• Custom defined tensor and unified global memory management
• 🔥 Encode and all-reduce overlap, we named "dual streams"
  • Support Int8-quantized all-reduce to further reduce all-reduce cost.
• Host all-reduce based on SIMD instructions
• Optimized fused kernels, qkv, residual & layernorm etc.
• 🔥 Fused batch attention for decoding based on tensor core instructions
• Support TP and PP on one node, TP is recommended
• Support dynamic batch
• Support flash attention prefill
• Support chunked prefill
• Support prefix cache
• Support Native INT8/SmoothQuant/FP8/AWQ/GPTQ quantization
• Support Marlin kernel for GPTQ
• Support MoE, DeepseekV2 MoE and DeepseekV2 MLA
• Support Llama/Llama2, Mixtral, Qwen2 series and similar models

🔧 Basic Usage

# Concurrently compile the wheel package, and turn off the unit test
CMAKE_BUILD_PARALLEL_LEVEL=32 TESTING=0 python setup.py bdist_wheel

# Compile with ninja backend
CMAKE_GENERATER="Ninja" python setup.py bdist_wheel

# Install directly
cd ./ZhiLight && pip install -e .

# Start OpenAI compatible server
python -m zhilight.server.openai.entrypoints.api_server [options]

✈️ Docker Image

ZhiLight only depends on the CUDA runtime, cuBLAS, NCCL, and a few Python packages in requirements.txt. You can use the image below for running or building it. You can also directly refer to docker/Dockerfile.

docker pull ghcr.io/zhihu/zhilight/zhilight:0.4.8-cu124

📈 Performance Notes

We conducted performance reviews on various mainstream NVIDIA GPUs with different model sizes and precisions. For dense models ranging from 2B to 110B parameters on PCIe devices, ZhiLight demonstrates significant performance advantages compared to mainstream open-source inference engines.

Test Description:

• Test purpose is to demonstrate performance, applicable scenarios and limitations
• Test metrics include:
  • QPS: Queries Per Second
  • TTFT (Time To First Token): First token generation latency
  • TPOT (Time Per Output Token): Generation latency per output token
• Test environments include:
  • AD102 PCIe : Consumer-grade GPU for experimental research
  • A800: Data center GPU for production deployment
  • H20: Data center GPU for production deployment
• Test models include:
  • Large-scale models: DeepSeek-R1, Qwen1.5-110B, Qwen2-72B, LLama-3.1-70B
  • Medium-scale models: Qwen2.5-14B, Llama-3.1-8B, Minicpm-2B
• Compared inference engines include:
  • vLLM
  • SGLang
  • ZhiLight

DeepSeek-R1 AWQ

• NVIDIA A800*8

• NVIDIA H20*8

MiniCPM-2B-sft-bf16

• NVIDIA AD102 PCIe * 1

Qwen2-72B-Instruct-GPTQ-Int4

• NVIDIA AD102 PCIe * 4

• NVIDIA A800 * 4

Qwen1.5-110B-Chat-GPTQ-Int4

• NVIDIA AD102 PCIe * 4

• NVIDIA A800 * 4

more benchmarks can be found in benchmarks

License

Apache License 2.0

Contributors

• @a710128
• @spetrel
• @unix1986
• @gnap