Homunculus needs about 9.5 GB of memory at Q4_K_M (a 7.6 GB file) with an 8K context window, so it fits on a 12 GB GPU. This repository has 25 quants, from 0.0 GB to 10.2 GB (Q6_K). Longer context needs more: at 32K tokens the KV cache alone adds about 5.4 GB.
Homunculus 12B instruction model distilled from Qwen3-235B
Homunculus is a 12.5‑billion‑parameter instruction model built on the llama architecture. It supports reasoning and tool use and was distilled onto the Mistral‑Nemo backbone. The model can handle up to 131072 context tokens.
Good at
- Reasoning with chain‑of‑thought
- Tool‑based interactions
- Large context handling
Limits
- No vision support
- Requires 8‑k context for memory estimates
- Apache‑2.0 license
Best for
- Research on reasoning‑trace distillation
- Lightweight production deployments
- Mode‑switchable assistants
Who it’s for. Researchers and developers needing a 12B instruction model with strong reasoning and tool use capabilities. Suitable for lightweight production environments that can accommodate the model’s memory requirements.
Quants & memory
| Quant | File | Est. memory | vs VRAM | Result | |
|---|---|---|---|---|---|
| — | 0.0 GB | 1.8 GB | Fits | Get file → | |
| IQ1_S | 3.1 GB | 4.9 GB | Fits | Get file → | |
| IQ1_M | 3.3 GB | 5.2 GB | Fits | Get file → | |
| IQ2_XXS | 3.7 GB | 5.5 GB | Fits | Get file → | |
| IQ2_XS | 4.0 GB | 5.9 GB | Fits | Get file → | |
| IQ2_S | 4.3 GB | 6.1 GB | Fits | Get file → | |
| IQ2_M | 4.6 GB | 6.4 GB | Fits | Get file → | |
| Q2_K_S | 4.6 GB | 6.5 GB | Fits | Get file → | |
| Q2_K | 4.9 GB | 6.8 GB | Fits | Get file → | |
| IQ3_XXS | 5.1 GB | 6.9 GB | Fits | Get file → | |
| IQ3_XS | 5.4 GB | 7.3 GB | Tight | Get file → | |
| Q3_K_S | 5.7 GB | 7.5 GB | Tight | Get file → | |
| IQ3_S | 5.7 GB | 7.5 GB | Tight | Get file → | |
| IQ3_M | 5.9 GB | 7.7 GB | Tight | Get file → | |
| Q3_K_M | 6.2 GB | 8.1 GB | Too big | Get file → | |
| Q3_K_L | 6.7 GB | 8.5 GB | Too big | Get file → | |
| IQ4_XS | 6.9 GB | 8.7 GB | Too big | Get file → | |
| Q4_0 | 7.2 GB | 9.1 GB | Too big | Get file → | |
| IQ4_NL | 7.2 GB | 9.1 GB | Too big | Get file → | |
| Q4_K_S | 7.3 GB | 9.1 GB | Too big | Get file → | |
| Q4_K_M | 7.6 GB | 9.5 GB | Too big | Get file → | |
| Q4_1 | 7.9 GB | 9.8 GB | Too big | Get file → | |
| Q5_K_S | 8.7 GB | 10.5 GB | Too big | Get file → | |
| Q5_K_M | 8.9 GB | 10.7 GB | Too big | Get file → | |
| Q6_K | 10.2 GB | 12.1 GB | Too big | Get file → |
For 8‑GB VRAM, use Q4_K_M (est. 9.5‑GB memory at 8‑k context). For 12‑GB VRAM, use Q5_K_M (est. 10.7‑GB memory). For larger VRAM, consider Q6_K (est. 12.1‑GB). File sizes range from 0.01‑GB (unknown quant) to 10.23‑GB (Q6_K).
What GPU do you need for Homunculus?
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 the main file (0.0 GB file, about 1.8 GB in use).
- 6 GB VRAM: the best quant that fits is IQ2_XS (4.0 GB file, about 5.9 GB in use).
- 8 GB VRAM: the best quant that fits is IQ3_M (5.9 GB file, about 7.7 GB in use).
- 12 GB VRAM: the best quant that fits is Q5_K_M (8.9 GB file, about 10.7 GB in use).
- 16 GB VRAM: the best quant that fits is Q6_K (10.2 GB file, about 12.1 GB in use).
Which Homunculus quant should you choose?
Q4_K_M is the usual starting point for Homunculus: it balances file size and quality well. Here it is a 7.6 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 Homunculus
How much VRAM does Homunculus need?
About 9.5 GB at Q4_K_M with an 8K context window. That is the 7.6 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 Homunculus on an 8 GB GPU?
Yes, with IQ3_M: the 5.9 GB file needs about 7.7 GB at 8K context. Larger quants in this repository do not fit in 8 GB.
What is the file size of Homunculus GGUF?
It depends on the quant: file is 0.0 GB, IQ1_S is 3.1 GB, IQ1_M is 3.3 GB, IQ2_XXS is 3.7 GB, IQ2_XS is 4.0 GB, IQ2_S is 4.3 GB and 19 more.
What context length does Homunculus support?
The GGUF header lists a trained context length of 131,072 tokens (128K). The KV cache grows with the context you use: about 1.3 GB at 8K and 5.4 GB at 32K.
Where can I download Homunculus GGUF?
The files are on Hugging Face in the mradermacher/Homunculus-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 Homunculus 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 Homunculus on 8 GB VRAM?
Yes, the Q4_K_M quant uses about 9.5‑GB memory at 8‑k context, which fits within 8‑GB VRAM with some overhead.
Does Homunculus support tool use?
Yes, the model has detected tool‑use ability and can execute tools when prompted.