TH

Tholos 2B

TholosGGUF by mertkayacsUpdated 2026-10-18
Download on Hugging Face
Parameters2.52B
Context128K
Layers42
Architecturellama
Smallest quant1.6 GB
Quick answer

Tholos 2B needs about 2.4 GB of memory at Q4_K_M (a 1.6 GB file) with an 8K context window, so it fits on a 4 GB GPU. This repository has 2 quants, from 1.6 GB (Q4_K_M) to 2.7 GB (Q8_0). Longer context needs more: at 32K tokens the KV cache alone adds about 1.4 GB.

Tholos 2B – 2.52B parameter model for local AI agents and tool use

Tholos 2B is a 2.52B parameter llama model designed for local AI assistants that choose tools for tables, notes and tasks. It passes 137/160 scenarios on Tholos‑Bench with Q4_K_M. The model is available in GGUF format for Ollama and llama.cpp.

Good at

  • Tool selection for AI assistants
  • JSON schema decoding
  • Reasoning tasks

Limits

  • No vision support
  • Requires 16,384-token context
  • Apache‑2.0 license

Best for

  • Local AI agents that need tool use
  • Table and note processing
  • Task automation

Who it’s for. Developers building local AI assistants that require tool selection and reasoning. The model is suitable for projects that need a lightweight, open‑source solution with a 2.52B parameter size.

Quants & memory

QuantFileEst. memoryvs VRAMResultDownload
Q4_K_M1.6 GB 2.4 GB
Fits Get file →
Q8_02.7 GB 3.5 GB
Fits Get file →

For 8 GB VRAM use the Q4_K_M build (1.56 GB, ~2.4 GB memory at 8 k context). For 12 GB VRAM use the Q8_0 build (2.68 GB, ~3.5 GB memory at 8 k context). Memory estimates are approximate.

What GPU do you need for Tholos 2B?

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 Q8_0 (2.7 GB file, about 3.5 GB in use).

Which Tholos 2B quant should you choose?

Q4_K_M is the usual starting point for Tholos 2B: it balances file size and quality well. Here it is a 1.6 GB file.

The Q8_0 file is 2.7 GB, about 1.7 times the size of Q4_K_M. It keeps the weights closer to the original, which only matters if you have the memory to spare.

New to quant names? Read GGUF quantization explained.

Specifications

Architecture from the GGUF header

Architecturellama
Parameters2.52B
Layers42
Trained context131,072 tokens
KV cache (fp16)42 KB per token

Source

Quantized bymertkayacs
FamilyTholos
Licenseapache-2.0
Downloads (HF)540
Last updated2026-10-18

Frequently asked questions about Tholos 2B

How much VRAM does Tholos 2B need?

About 2.4 GB at Q4_K_M with an 8K context window. That is the 1.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 Tholos 2B on an 8 GB GPU?

Yes, with Q8_0: the 2.7 GB file needs about 3.5 GB at 8K context. Larger quants in this repository do not fit in 8 GB.

What is the file size of Tholos 2B GGUF?

It depends on the quant: Q4_K_M is 1.6 GB, Q8_0 is 2.7 GB.

What context length does Tholos 2B support?

The GGUF header lists a trained context length of 131,072 tokens (128K). The KV cache grows with the context you use: about 0.4 GB at 8K and 1.4 GB at 32K.

Where can I download Tholos 2B GGUF?

The files are on Hugging Face in the mertkayacs/Tholos-2B-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 Tholos 2B 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 Tholos 2B on 8 GB VRAM?

Yes, the Q4_K_M quantized model is 1.56 GB and requires about 2.4 GB of VRAM at 8 k context.

Does Tholos 2B support vision tasks?

No, the model has no vision capabilities.

Other GGUFs of Tholos-2B

Similar models

Browse all →

More from mertkayacs

All by mertkayacs →

More Tholos models

All Tholos →

Other tiny models

All tiny models →