--- license: other license_name: nvidia-open-model-license license_link: https://developer.download.nvidia.com/licenses/nvidia-open-model-license-agreement-june-2024.pdf base_model: nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16 tags: - gguf - rotorquant - kv-cache-quantization - nemotron - nvidia - mamba2 - hybrid - moe - llama-cpp - quantized library_name: gguf pipeline_tag: text-generation --- # Nemotron-3-Super-120B-A12B-RotorQuant-GGUF-Q2_K GGUF Q2_K weight-quantized variant of [nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16](https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16) optimised for use with **RotorQuant** KV cache compression via a dedicated llama.cpp fork. > **Important:** RotorQuant KV cache types (`planar3`, `iso3`) are **not** available in upstream llama.cpp, standard Ollama, or LM Studio. > They require a [specific llama.cpp fork](https://github.com/johndpope/llama-cpp-turboquant/tree/feature/planarquant-kv-cache). > The GGUF file itself is a standard GGUF and works with any llama.cpp-compatible runtime using normal KV cache types (f16, q8_0, q4_0, etc.). ## Hardware compatibility | Device | VRAM / RAM | Recommendation | | --- | --- | --- | | CPU host with ≥48 GB RAM | ~47.5 GB | works via llama.cpp; slower than GPU but no accelerator required | | Apple Silicon (Metal) | ~51.8 GB | llama.cpp Metal backend; fast on M-series unified memory | | NVIDIA GPU (partial offload) | split between GPU + RAM | offload as many layers as VRAM allows; rest on CPU | ## Overview This model combines two independent compression techniques: | Technique | What it does | Requirement | |-----------|-------------|-------------| | **GGUF Q2_K weight quantization** | Reduces model size from ~240 GB (BF16) to ~43.2 GB | Any llama.cpp-compatible runtime | | **RotorQuant KV cache compression** — block-diagonal Clifford-algebra rotors for 3-bit KV cache (`--cache-type-k iso3 --cache-type-v iso3`) | Block-diagonal rotations / random rotation for compressed KV cache | [llama-cpp-turboquant fork](https://github.com/johndpope/llama-cpp-turboquant/tree/feature/planarquant-kv-cache) only | ## Quickstart ### Option A — With RotorQuant KV cache (fork required) You must build from the RotorQuant-enabled llama.cpp fork: ```bash # Clone and build the fork git clone https://github.com/johndpope/llama-cpp-turboquant.git cd llama-cpp-turboquant && git checkout feature/planarquant-kv-cache # CUDA (Windows/Linux) cmake -B build -DGGML_CUDA=ON -DCMAKE_BUILD_TYPE=Release && cmake --build build -j # Metal (Apple Silicon) cmake -B build -DGGML_METAL=ON -DGGML_METAL_EMBED_LIBRARY=ON -DCMAKE_BUILD_TYPE=Release && cmake --build build -j # Run with RotorQuant KV cache ./build/bin/llama-cli -m Nemotron-3-Super-120B-A12B-RotorQuant-GGUF-Q2_K.gguf \ --cache-type-k iso3 --cache-type-v iso3 \ -ngl 99 -fa \ -p "Explain quantum computing" # Or run as a server ./build/bin/llama-server -m Nemotron-3-Super-120B-A12B-RotorQuant-GGUF-Q2_K.gguf \ --cache-type-k iso3 --cache-type-v iso3 \ -ngl 99 -fa --jinja ``` ### Option B — With standard llama.cpp / LM Studio / Ollama The GGUF works as a normal quantised model. You won't get RotorQuant-specific KV cache benefits, but standard KV cache quantization (q8_0, q4_0) still reduces VRAM significantly. **llama.cpp (upstream)** ```bash llama-cli -m Nemotron-3-Super-120B-A12B-RotorQuant-GGUF-Q2_K.gguf \ --cache-type-k q8_0 --cache-type-v q8_0 \ -ngl 99 -fa \ -p "Explain quantum computing" ``` **LM Studio** 1. Download the GGUF file and load in LM Studio. 2. Enable **Developer Mode** (Settings → Developer). 3. In the model loader's advanced settings, set **Flash Attention** to ON. 4. Set **K Cache Quantization** and **V Cache Quantization** to `q8_0` (or `q4_0` for more aggressive VRAM savings). 5. Note: LM Studio does not currently support RotorQuant's `iso3` cache types. Track [this feature request](https://github.com/lmstudio-ai/lmstudio-bug-tracker/issues/1719) for updates. **Ollama** ```bash # Standard Ollama does not support RotorQuant cache types. # Use with default or q8_0 KV cache via OLLAMA_KV_CACHE_TYPE=q8_0 OLLAMA_KV_CACHE_TYPE=q8_0 OLLAMA_FLASH_ATTENTION=1 ollama run majentik/Nemotron-3-Super-120B-A12B-RotorQuant-GGUF-Q2_K ``` ## Specifications | Property | Value | |----------|-------| | Base Model | [nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16](https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16) | | Architecture | Mamba-2 + Transformer hybrid Sparse MoE | | Parameters | 120B total, 12B active per token | | Context Length | 1M | | Weight Quantization | GGUF Q2_K (aggressive 2-bit, noticeable quality drop) | | Original Size (BF16) | ~240 GB | | Quantized File Size | ~43.2 GB | | KV Cache (RotorQuant) | 3-bit via `--cache-type-k iso3 --cache-type-v iso3` (fork only) | | KV Cache (standard) | q8_0, q4_0, f16, etc. (any llama.cpp runtime) | | License | other | | Modalities | Text only | | Compatible Runtimes | llama.cpp, LM Studio, Ollama, koboldcpp | ## What is RotorQuant? [RotorQuant](https://github.com/scrya-com/rotorquant) is a KV cache compression method based on Clifford algebra (Cl(3,0)) rotors. It was developed as a faster, more parameter-efficient alternative to Google's [TurboQuant](https://arxiv.org/abs/2504.19874) (ICLR 2026). Instead of applying a dense d×d random orthogonal rotation matrix (as TurboQuant does), RotorQuant uses lightweight block-diagonal rotations — independent 2D/4D rotations per pair/quartet — achieving O(d) complexity instead of O(d log d), fully parallelisable with no inter-element dependencies. **Benchmarks from the RotorQuant repository** (Llama 3.1 8B, RTX 5090 — results will vary by model and hardware): | Metric | RotorQuant (iso3) | TurboQuant | Standard q4_0 | |--------|-------------------|------------|---------------| | Prefill Speed | 3,822 tok/s | 722 tok/s | — | | Decode Speed | 119 tok/s | 93 tok/s | — | | Perplexity (PPL) | 6.91 | 7.07 | — | | KV Compression | ~5× vs FP16 | ~5× vs FP16 | ~4× vs FP16 | | Rotation Parameters | 4 per rotor | 16,384 per matrix | N/A | > **Note:** These benchmarks are from the RotorQuant repository using Llama 3.1 8B on an RTX 5090. Performance on Nemotron-3-Super-120B-A12B will differ. Independent benchmarks for this specific model are welcome — please open a discussion if you have results to share. ## Current Status of RotorQuant in the Ecosystem | Runtime | RotorQuant Support | Standard KV Quant | |---------|---------------------|-------------------| | llama.cpp (upstream) | ❌ Not merged | ✅ q8_0, q4_0, q4_1, iq4_nl, q5_0, q5_1 | | llama-cpp-turboquant fork | ✅ planar3, iso3 | ✅ All standard types | | LM Studio | ❌ [Requested](https://github.com/lmstudio-ai/lmstudio-bug-tracker/issues/1719) | ✅ Via advanced settings | | Ollama | ❌ Not supported | ✅ Via OLLAMA_KV_CACHE_TYPE | | koboldcpp | ❌ Not supported | ✅ Standard types | ## Recommended Settings For VRAM-constrained setups, standard q8_0 KV cache quantization already halves KV cache memory with negligible quality impact. Flash Attention should always be enabled — it is required for V cache quantization and improves memory efficiency regardless. | VRAM | Suggested Configuration | |------|------------------------| | 24 GB (RTX 4090) | Q2_K + q8_0 KV cache + Flash Attention, 8K–16K context | | 16 GB | Q2_K + q4_0 KV cache + Flash Attention, 4K–8K context | | 48+ GB | Q2_K + f16 KV cache, full 32K+ context | ## See Also - [RotorQuant GitHub](https://github.com/scrya-com/rotorquant) - [llama-cpp-turboquant fork](https://github.com/johndpope/llama-cpp-turboquant/tree/feature/planarquant-kv-cache) - [TurboQuant llama.cpp discussion](https://github.com/ggml-org/llama.cpp/discussions/20969) - [TurboQuant paper (arXiv: 2504.19874)](https://arxiv.org/abs/2504.19874) - [Base model: nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16](https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16) - [Nemotron-3-Super-120B-A12B announcement](https://developer.nvidia.com/blog/introducing-nemotron-3-super-an-open-hybrid-mamba-transformer-moe-for-agentic-reasoning/)