Aztec Coder 4B needs about 4.3 GB of memory at Q4_K_M (a 2.7 GB file) with an 8K context window, so it fits on a 6 GB GPU. This repository has 25 quants, from 0.0 GB to 3.5 GB (Q6_K). Longer context needs more: at 32K tokens the KV cache alone adds about 4.3 GB.
Aztec Coder 4B – a 4B‑parameter agentic coding model
Aztec Coder 4B is a 4B‑parameter model fine‑tuned from Qwen3.5‑4B. It can investigate bugs, edit files, run commands, and verify fixes in software repositories. The model is designed to run on consumer GPUs and is available in multiple GGUF quantizations.
Good at
- Bug investigation and repair
- File editing and command execution
- Self‑verification of fixes
Limits
- Requires 8‑k context for full operation
- Safety alignment slightly reduced in some quantizations
- No vision support
Best for
- Local coding assistants
- Debugging open‑source projects
- Automated code review
Who it’s for. Developers and researchers who need an agentic coding model that can run on a laptop. The model is a research preview and not recommended for production use.
Quants & memory
| Quant | File | Est. memory | vs VRAM | Result | |
|---|---|---|---|---|---|
| — | 0.0 GB | 1.6 GB | Fits | Get file → | |
| IQ1_S | 1.4 GB | 2.9 GB | Fits | Get file → | |
| IQ1_M | 1.4 GB | 3.0 GB | Fits | Get file → | |
| IQ2_XXS | 1.5 GB | 3.1 GB | Fits | Get file → | |
| IQ2_XS | 1.6 GB | 3.2 GB | Fits | Get file → | |
| IQ2_S | 1.7 GB | 3.2 GB | Fits | Get file → | |
| IQ2_M | 1.7 GB | 3.3 GB | Fits | Get file → | |
| Q2_K_S | 1.9 GB | 3.4 GB | Fits | Get file → | |
| IQ3_XXS | 1.9 GB | 3.5 GB | Fits | Get file → | |
| Q2_K | 1.9 GB | 3.5 GB | Fits | Get file → | |
| Q3_K_S | 2.1 GB | 3.6 GB | Fits | Get file → | |
| IQ3_XS | 2.1 GB | 3.7 GB | Fits | Get file → | |
| IQ3_S | 2.1 GB | 3.7 GB | Fits | Get file → | |
| IQ3_M | 2.2 GB | 3.7 GB | Fits | Get file → | |
| Q3_K_M | 2.3 GB | 3.8 GB | Fits | Get file → | |
| Q3_K_L | 2.4 GB | 4.0 GB | Fits | Get file → | |
| IQ4_XS | 2.5 GB | 4.1 GB | Fits | Get file → | |
| Q4_0 | 2.5 GB | 4.1 GB | Fits | Get file → | |
| Q4_K_S | 2.6 GB | 4.1 GB | Fits | Get file → | |
| IQ4_NL | 2.6 GB | 4.2 GB | Fits | Get file → | |
| Q4_K_M | 2.7 GB | 4.3 GB | Fits | Get file → | |
| Q4_1 | 2.8 GB | 4.3 GB | Fits | Get file → | |
| Q5_K_S | 3.0 GB | 4.6 GB | Fits | Get file → | |
| Q5_K_M | 3.1 GB | 4.6 GB | Fits | Get file → | |
| Q6_K | 3.5 GB | 5.0 GB | Fits | Get file → |
For 8 GB VRAM, use Q4_0 (2.55 GB file, ~4.1 GB memory). For 12 GB VRAM, Q5_K_M (3.07 GB file, ~4.6 GB memory) or Q6_K (3.46 GB file, ~5 GB memory). Smaller quants such as IQ1_S (1.36 GB file, ~2.9 GB memory) fit on 4 GB VRAM but offer lower quality.
What GPU do you need for Aztec Coder 4B?
These figures add the file size, an fp16 KV cache at an 8K context window (worked out from this model’s own header) and about 0.5 GB for the runtime. They are estimates, so leave a little headroom, and expect to use less context or a smaller quant if you are right at the limit.
- 4 GB VRAM: the best quant that fits is Q3_K_L (2.4 GB file, about 4.0 GB in use).
- 6 GB VRAM: the best quant that fits is Q6_K (3.5 GB file, about 5.0 GB in use).
Which Aztec Coder 4B quant should you choose?
Q4_K_M is the usual starting point for Aztec Coder 4B: it balances file size and quality well. Here it is a 2.7 GB file.
If memory is tight, the smallest file is the first one in the table at 0.0 GB, with the quality trade-offs that come with fewer bits.
New to quant names? Read GGUF quantization explained.
Specifications
Architecture from the GGUF header
Source
Frequently asked questions about Aztec Coder 4B
How much VRAM does Aztec Coder 4B need?
About 4.3 GB at Q4_K_M with an 8K context window. That is the 2.7 GB file, plus the KV cache and roughly 0.5 GB of runtime overhead. Smaller quants need less and longer context needs more.
Can I run Aztec Coder 4B on an 8 GB GPU?
Yes, with Q6_K: the 3.5 GB file needs about 5.0 GB at 8K context. Larger quants in this repository do not fit in 8 GB.
What is the file size of Aztec Coder 4B GGUF?
It depends on the quant: file is 0.0 GB, IQ1_S is 1.4 GB, IQ1_M is 1.4 GB, IQ2_XXS is 1.5 GB, IQ2_XS is 1.6 GB, IQ2_S is 1.7 GB and 19 more.
What context length does Aztec Coder 4B support?
The GGUF header lists a trained context length of 262,144 tokens (256K). The KV cache grows with the context you use: about 1.1 GB at 8K and 4.3 GB at 32K.
Where can I download Aztec Coder 4B GGUF?
The files are on Hugging Face in the mradermacher/Aztec-Coder-4B-i1-GGUF repository. The download buttons on this page open the file on Hugging Face. ggufmodels.com does not host any model files.
What license does Aztec Coder 4B use?
Hugging Face lists the license as apache-2.0. Licenses can differ between the quantized files and the original model, so check the repository and the base model before commercial use.
Can I run Aztec Coder 4B on 8 GB VRAM?
Yes, the Q4_0 quant uses about 4.1 GB VRAM at 8‑k context, which fits on an 8 GB GPU.
Is the model safe for production use?
It is a research preview; safety alignment is reduced in some quantizations and it is not recommended for production.
What context length does the model support?
The model was trained with 262,144 tokens and works with 8‑k context for the provided quants.