HQQ gives you calibration-free quantization down to 4/3/2-bit precision, which means you can quantize any model in minutes without needing sample datasets. The real advantage here is speed and flexibility: while GPTQ and AWQ require hours and calibration data, HQQ just works immediately with multiple backend options like Marlin, TorchAO, and BitBlas for different hardware. It integrates natively with HuggingFace and vLLM, and you can fine-tune the quantized models with LoRA if needed. The tradeoff is that calibration-based methods like AWQ will generally give you better accuracy for production serving, but if you're experimenting with extreme quantization or need to compress models fast without datasets, this is the pragmatic choice.

skills.sh installs
1K
GitHub stars
14.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add orchestra-research/ai-research-skills --skill hqq-quantization --agent claude-code

Installs into .claude/skills of the current project.

Files

HQQ - Half-Quadratic Quantization

Fast, calibration-free weight quantization supporting 8/4/3/2/1-bit precision with multiple optimized backends.

When to use HQQ

Use HQQ when:

  • Quantizing models without calibration data (no dataset needed)
  • Need fast quantization (minutes vs hours for GPTQ/AWQ)
  • Deploying with vLLM or HuggingFace Transformers
  • Fine-tuning quantized models with LoRA/PEFT
  • Experimenting with extreme quantization (2-bit, 1-bit)

Key advantages:

  • No calibration: Quantize any model instantly without sample data
  • Multiple backends: PyTorch, ATEN, TorchAO, Marlin, BitBlas for optimized inference
  • Flexible precision: 8/4/3/2/1-bit with configurable group sizes
  • Framework integration: Native HuggingFace and vLLM support
  • PEFT compatible: Fine-tune quantized models with LoRA

Use alternatives instead:

  • AWQ: Need calibration-based accuracy, production serving
  • GPTQ: Maximum accuracy with calibration data available
  • bitsandbytes: Simple 8-bit/4-bit without custom backends
  • llama.cpp/GGUF: CPU inference, Apple Silicon deployment

Quick start

Installation

pip install hqq

Sponsors

Details

Repository
github.com/orchestra-research/ai-research-skills
Categories
AI & Agent Building, Data Science & ML
First seen
Jun 3, 2026

More from orchestra-research/ai-research-skills

All 95
1orchestra-research avatarhuggingface-tokenizersorchestra-research/ai-research-skillsFast tokenizers optimized for research and production. Rust-based implementation tokenizes 1GB in <20 seconds. Supports BPE, WordPiece, and Unigram algorithms. 1Kskills.sh installs
2orchestra-research avatarlong-contextorchestra-research/ai-research-skillsExtend context windows of transformer models using RoPE, YaRN, ALiBi, and position interpolation techniques. Use when processing long documents (32k-128k+ token1Kskills.sh installs
3orchestra-research avatarnanogptorchestra-research/ai-research-skillsEducational GPT implementation in ~300 lines. Reproduces GPT-2 (124M) on OpenWebText. Clean, hackable code for learning transformers. By Andrej Karpathy. Perfec1Kskills.sh installs
4orchestra-research avatarpytorch-fsdp2orchestra-research/ai-research-skillsAdds PyTorch FSDP2 (fully_shard) to training scripts with correct init, sharding, mixed precision/offload config, and distributed checkpointing. Use when models1Kskills.sh installs
5orchestra-research avatarmodal-serverless-gpuorchestra-research/ai-research-skillsServerless GPU cloud platform for running ML workloads. Use when you need on-demand GPU access without infrastructure management, deploying ML models as APIs, o1Kskills.sh installs
6orchestra-research avatarmoe-trainingorchestra-research/ai-research-skillsTrain Mixture of Experts (MoE) models using DeepSpeed or HuggingFace. Use when training large-scale models with limited compute (5× cost reduction vs dense mode1Kskills.sh installs