Model or dataset
intel/auto-round avatar
intel/auto-round

Intel AutoRound: Sign-Gradient Quantization for Low-Bit LLMs and VLMs

Intel AutoRound is a model optimization toolkit for quantization workflows that lowers inference cost while preserving accuracy for AI deployment.

1,614 stars175 forksPythonApache-2.0

At a glance

What is it?
Intel AutoRound is a Python toolkit that quantizes large language and vision-language models down to 2-4 bits using sign-gradient descent. It targets engineers who need accuracy-preserving low-bit inference across Transformers, vLLM, SGLang, and multiple export formats.
Who is it for?
Adopt AutoRound if you need 2-4 bit quantization for LLMs or VLMs and want to export to AutoAWQ, AutoGPTQ, GGUF, or native AutoRound formats for deployment in vLLM, SGLang, or Transformers. Do not use it if you require calibration-free quantization without any tuning, or if you cannot tolerate the extra RAM overhead from torch.compile (about 10 GB) or the tuning cost of AutoScheme.
Can I use it commercially?
Yes. Apache-2.0 is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 1 day ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 14, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What AutoRound Solves and Who It Is For

AutoRound addresses the accuracy drop that usually comes with quantizing large language models (LLMs) and vision-language models (VLMs) to very low bit widths, specifically 2 to 4 bits. Standard round-to-nearest quantization often degrades model quality at those levels. AutoRound uses sign-gradient descent to adjust rounding decisions during quantization, which the README claims achieves high accuracy with minimal tuning. This toolkit is for engineers who deploy LLMs or VLMs in production and need to lower inference cost, whether that means smaller memory footprint or faster serving. It is also for researchers who want to experiment with aggressive quantization schemes without building the optimization loop from scratch. The project explicitly targets integration with popular serving stacks: Transformers, vLLM, SGLang, and LLM-Compressor are all mentioned in the README. If you are working with 8-bit or 16-bit quantization, AutoRound is overkill; its value is concentrated in the ultra-low bit regime.

The Mechanism: Sign-Gradient Descent and Block-Wise Optimization

The core mechanism is sign-gradient descent, described in the SignRoundV1 and SignRoundV2 papers. Instead of using the full gradient magnitude to update rounding decisions, the method uses only the sign of the gradient. This simplifies the optimization and, according to the README, leads to strong accuracy at 2-3 bits. Quantization is performed block-wise, meaning the model is processed in blocks rather than as a whole, which reduces memory pressure and allows the optimizer to focus on local weight distributions. The README also mentions a model-free mode for quantization, where the `auto-round-rtn` command defaults to this approach. This mode likely avoids loading the full model for calibration, which is useful for very large models. The toolkit also supports algorithm composition, where you can combine methods like `awq` and `signround` in a single pass, as shown in the `--algs` CLI flag. This composition is experimental as of August 2026, so expect some rough edges.

Getting It Running: Commands and Configuration

The primary interface is a command-line tool, `auto-round`, with subcommands for different quantization modes. For a basic round-to-nearest quantization, you would use `auto-round-rtn`, which now defaults to model-free mode. To enable block-wise FP8 quantization, the README shows: `auto-round-rtn --scheme FP8_BLOCK`. For more advanced algorithms, you pass `--enable_alg_ext` to activate improved INT2 or enhanced GGUF algorithms. The Python API offers the same options, and you can disable the default `torch.compile` acceleration by passing `enable_torch_compile=False` or `--disable_torch_compile` on the CLI. The README warns that `torch.compile` adds about 10 GB of extra RAM usage and may introduce minor numerical differences. For mixed-precision quantization, the AutoScheme API generates schemes in minutes, with about 1.1X to 1.5X the model's BF16 RAM size as overhead. The full user guide is in `docs/step_by_step.md`, which you should read before running anything.

Export Formats and Ecosystem Integration

AutoRound does not lock you into a single deployment format. The README lists support for AutoRound, AutoAWQ, AutoGPTQ, and GGUF. This is a practical advantage because it lets you quantize once and then export to the format that your serving stack expects. For instance, vLLM integration is documented, and the README mentions a vLLM-Omni integration. SGLang also has a usage guide linked. Transformers integration is noted via a Hugging Face blog. The export flexibility is one of the strongest arguments for adopting AutoRound, as it reduces the risk of being tied to a proprietary format. However, the README also notes that for GGUF format, the AutoScheme refinement incurs additional tuning cost. So the flexibility comes with a trade-off: more formats mean more configuration and more time spent on tuning.

Limitations and Failure Modes

The most obvious limitation is the extra RAM usage from `torch.compile`, which the README states is about 10 GB. On memory-constrained machines, this could be a dealbreaker. The README also says that minor numerical differences are expected when using `torch.compile` due to compiler optimizations. That means your quantized model might behave slightly differently between compiled and non-compiled paths. Another limitation is the tuning cost for AutoScheme, especially for GGUF. The README says the enhancement 'incurs additional tuning cost,' which could be significant for large models. Also, the algorithm composition feature is experimental, so you should not rely on it for production without testing. Finally, the vLLM deployment for AutoScheme WOQ requires shared layers to be configured per vLLM's fusion patterns. If you miss that step, the deployment may fail or produce incorrect results. These are concrete constraints, not hypothetical risks.

Alternative Approaches: GPTQ and AWQ

The obvious alternatives are GPTQ and AWQ, both of which AutoRound can actually export to. GPTQ uses second-order information to minimize quantization error, which is a different optimization objective than sign-gradient descent. AWQ focuses on protecting important weights by scaling them based on activation statistics. AutoRound's approach is to optimize the rounding itself, which is more granular. The key difference is that AutoRound is a training-like optimization loop, while GPTQ and AWQ are more analytical or heuristic. This means AutoRound can potentially achieve better accuracy at very low bits, but it may require more compute and memory during the quantization phase. If you are already using GPTQ or AWQ and are satisfied with the accuracy at 4 bits, switching to AutoRound may not be necessary. But if you need 2-3 bits, AutoRound's sign-gradient approach is a different tool worth evaluating.

Maintenance and License Considerations

The project is under Apache-2.0, which is permissive and allows commercial use, modification, and redistribution, provided you preserve the license notice. The repository shows active maintenance with a recent release (v0.14.2) pushed in July 2026. The README lists regular updates, including new dtypes like MXFP4 and NVFP4, and new algorithms. This suggests the project is evolving quickly, which is good for features but also means you should expect breaking changes between minor versions. The documentation is extensive, with multiple linked docs for accuracy results and step-by-step guides. There is no explicit mention of a migration guide or upgrade path, so you should check the release notes before upgrading. The project also integrates with external tools like LLM-Compressor and vLLM, which means you need to track those dependencies as well. Overall, the maintenance cost is moderate, but the fast pace of change means you should pin versions and test thoroughly before production use.

Editorial conclusion

Adopt AutoRound if you need 2-4 bit quantization for LLMs or VLMs and want to export to AutoAWQ, AutoGPTQ, GGUF, or native AutoRound formats for deployment in vLLM, SGLang, or Transformers. Do not use it if you require calibration-free quantization without any tuning, or if you cannot tolerate the extra RAM overhead from torch.compile (about 10 GB) or the tuning cost of AutoScheme. Before adopting, verify that your target hardware supports the quantized dtypes (e.g., MXFP4, NVFP4, FP8_BLOCK) and that your model architecture is compatible with the block-wise and mixed-precision algorithms. Check the latest release notes for algorithm composition and vLLM deployment caveats, especially shared layer fusion patterns.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Community notes

Community notes