Laguna-S-2.1 — GGUF quant suite (1–8 bit, imatrix)
Community GGUF quantizations of
poolside/Laguna-S-2.1,
covering the low-bit band (IQ1–IQ3) that the official release does not
ship — so you can run this 117B-parameter MoE on a single GPU.
Every file is quantized with poolside's official importance matrix
(laguna-s-2.1.imatrix, 400 chunks) from their official F16 GGUF, using the
laguna architecture in llama.cpp. Each file is load-and-generate smoke
tested on GPU before upload (see Verification below).
Uploading now, smallest first. Files appear as they finish. This card
lists the full planned suite; the Status column shows what is live.
Because only ~10 of 256 experts fire per token, decode is far faster than the
117B total suggests — this is what makes low-bit single-GPU serving practical.
Available quants
Recommended picks in bold. Sizes are file sizes; add KV cache + compute
buffers for total VRAM (see Hardware).
Split files: quants above ~48 GB are split with llama-gguf-split. Download
all parts (*-00001-of-000NN.gguf …) into one folder and point llama.cpp at
part 00001; it auto-merges. No manual concatenation.
Hardware / VRAM
Total VRAM ≈ file size + KV cache + ~0.5–1 GB compute buffers.
KV cache for this model is ~192 KiB/token in fp16 (~0.75 GB at 4K, ~1.5 GB
at 8K). Use -fa on and an fp8/q8 KV cache to cut that roughly in half.
Your GPU(s)
Recommended quant
Context
single 24 GB (3090/4090/RTX 6000)
IQ1_S
~4–8K on-GPU; longer via --n-cpu-moe offload
single 32 GB
IQ1_M / IQ2_M
comfortable mid context
48 GB (or 2×24)
IQ2_M / IQ3_XXS
long context
64 GB
Q3_K_M / IQ4_XS
long context, near-orig quality
80 GB+
IQ4_XS and up
full fidelity
Not enough VRAM? Because it's a sparse MoE, CPU-offloading the expert tensors
is cheap. Add --n-cpu-moe 40 (offload experts of 40 layers to RAM) or classic
-ngl partial offload; you keep most of the speed with a fraction of the VRAM.
How to run
⚠️ Requires poolside's llama.cpp fork (branch laguna) until upstream
support lands — see ggml-org/llama.cpp#25165.
Stock/mainline llama.cpp will error with unknown model architecture: 'laguna'.
1. Build the fork
bash
1git clone --branch laguna https://github.com/poolsideai/llama.cpp
2cd llama.cpp
3cmake -B build -DGGML_CUDA=ON -DCMAKE_BUILD_TYPE=Release # drop -DGGML_CUDA=ON for CPU-only4cmake --build build -j
The weights are native 1M checkpoints. To exceed 256K, override rope/YaRN at
load time per poolside's base card (e.g. --rope-scaling yarn --yarn-orig-ctx 262144); most users will not need this.
Verification
Each uploaded file was smoke-tested on GPU (offloaded, fresh load) and must
emit the expected continuation before upload — e.g. IQ1_S:
Prompt: "The capital of France is"
Output: "The capital of France is **Paris**."
Files that fail the load-and-generate check are not uploaded. Quant sizes
and short SHA-256 receipts are recorded in each file's commit message.
Choosing a quant
Want it to fit one 24 GB card? → IQ1_S. It's genuinely coherent for a
1.62-bit 117B model; expect some quality loss vs higher bits.
Best low-bit quality/size? → IQ2_M or Q3_K_M.
Near-original quality? → IQ4_XS and up (needs 64 GB+ or offload).
IQ (i-quants) are generally higher quality per byte than the same-size K-quant,
but need the imatrix (already baked in here) and are slightly slower on some
CPUs.
Credits & license
Base model, architecture, and importance matrix:
poolside — please cite/credit them.