Qwen3.8-27B-VQ-3.9bpw

Qwen3.8-27B-VQ-3.9bpw

12.5 GiB — the smallest build here that we would actually recommend.

A vector-quantized build of Qwen3.8-27B for Apple Silicon. Stock mlx-lm, no patches — the VQ runtime ships inside the checkpoint as model.py.

At the time of release no MLX-format quantization of this model had been published, so unlike our 397B and 35B releases, the affine builds compared against below are our own conversions (methodology and configuration in Comparators below).

Changelog

2026-10-01 — runtime refresh; Knurlogic

The bundled model.py is updated to the current VQ runtime; the weights are unchanged. The run, multi-Mac, drafting and vision instructions now use Knurlogic.

2026-09-17 — re-measured on the three-corpus KL instrument

Every number below was taken on one instrument: KL to the bf16 teacher's cached top-64, 12288 tokens (the ppl gate's own length), on all three house corpora — prose, public code and literary — scored through a streamed pass that reproduces a direct full-model forward to all printed decimals. The older table further down is prose-only at 2048 tokens and is not comparable to this one row-for-row; a 2048-token prose-only read has been shown to distort magnitudes and, on one occasion, to invert a sign outright.

KL is millinats per token; lower is closer to bf16. The affine rows are our own conversions with the stock community recipe (mlx_lm.convert, group_size 64, affine), carrying the same bf16 vision tower, scored on the same cache and the same positions.

Two things this instrument shows that a prose-only read cannot. First, this family's damage concentrates in literary text — every build here is several times worse there than on prose, and the older table never had that column. Second, perplexity does not rank these builds: the 8-bit affine row sits ~40x closer to bf16 than anything else while reading the highest perplexity of the five. Rank by KL.

2026-09-09 — runtime refresh

Runtime refresh. The bundled model.py is updated so downloaders run exactly the code that was benchmarked; dense bundles now carry both runtimes.

• Faster prefill on affected geometries, measured per rung: a device-codebook kernel arm for large-codebook geometries (up to 1.46x on affected rungs), a ragged-subvector relaxation (up to 1.34x on affected rungs), a fused d8 arm, and a routing memo (≈2%). No blanket speedup is claimed across the lineup — gains apply only where the geometry engages the new paths.
• Output quality is unchanged: the kernel changes are bit-identical or 1-ULP-equivalent, and the routing memo is bit-identical (logits checksum verified).
• Speculative decoding (MTP): on repos that ship mtp-head-q6.safetensors, the sidecar works with the exo fork branch mtp-stage1 (github.com/noahzelezny/exo) — launch each node with exo --mtp (or set EXO_MTP=1). Note: with MTP enabled, exo serves requests sequentially (the batch engine has no MTP path), so leave it off for concurrent / multi-agent workloads.

2026-09 — bundle repair

Bundle repair — if mlx-lm gave you ModuleNotFoundError, this fixes it.

The previous model.py depended on a module our internal environment injected into mlx-lm, so on a stock install the model failed to load at all. The bundle is now fully self-contained and gated by a load-and-generate check in a verified-clean environment before upload. The weights are unchanged; only model.py is replaced. The prior revision remains pinnable by commit hash, but for this model there is no reason to pin it.

The bundled runtime also picks up the 2026-09 kernel refresh: the dense VQ kernels now read activations directly from device memory instead of staging through threadgroup tiles (bit-identical outputs, verified), and prefill evaluates incrementally. Decode is meaningfully faster than the previous bundle and peak memory now equals the on-disk size (figures below are re-measured on this revision).

Measured results

Superseded — see the 2026-09-17 entry in the changelog above. The table below is the original prose-only measurement at 2048 tokens; it is kept for provenance and is not comparable row-for-row with the three-corpus table.

Scored against the bf16 teacher on the same corpus with an unmodified mlx-lm. All sizes include the 333-tensor bf16 vision tower (0.859 GiB), carried by every build here.

Against our own 3-bit conversion at 11.8 GiB it more than halves the divergence — 85.8 millinats against 187.8 — for 0.6 GiB more. Against the 4-bit at 15.0 GiB it gives up real quality to save 2.5 GiB. That is the trade this rung exists for.

Rank these by KL, not perplexity. On this instruction-tuned family perplexity barely moves — every build from 3-bit upward sits between 5.19 and 5.35, inside the measurement's own noise — while divergence from the teacher moves by a factor of forty across the same range. Perplexity is an aggregate over finite text and absorbs offsetting errors; KL measures distance to the teacher's distribution directly.

Comparators

The affine rungs above are local conversions made with mlx_lm.convert using default settings, verified uniform per-module.

Where this stops paying

Above roughly 5 bits per weight the advantage reverses on this model: our 6-bit affine conversion reaches 3.7 millinats at 21.2 GiB, which no VQ rung we measured approaches at that size. Builds larger than the ones released here were measured and deliberately not published for that reason.

Runtime

Speed on this revision (measured 2026-10-01)

One Mac Studio M3 Ultra, vqlab speed-pair: a fresh process per run, alternating with the reference, 3 pairs, 2048-token prompt, 128 generated tokens, no drafting.

Throughput differs across Apple silicon; compare the ratio, not the absolute numbers.

Earlier figures (previous runtime)

Decode 23.3 tok/s · prefill ≈23 tok/s · resident 12.2 GB. Apple M3 Ultra, mlx-lm generate, 2048-token prompt, 128 greedy tokens, no drafting head. Resident is process RSS, which stays at about the 12.5 GiB on disk — this runs in its own size.

On the same machine, prompt and harness, stock Qwen3.8-27B-8bit runs at 23.7 tok/s in 27.5 GB of weights.

Throughput on other Apple silicon differs a lot — that same stock baseline measures 16.7 tok/s on an M4 Max — so compare within a machine, not across these numbers.

Peak memory, measured externally (2026-09-03): process RSS sampled at 5 Hz from outside the process across load + 2048-token prefill + 128-token decode peaks at 12.5 GiB — equal to the on-disk size. The bundled runtime returns transient prefill allocations to the OS as they free (buffer-cache cap, VQLAB_CACHE_LIMIT_GB overrides) and the prefill graph is evaluated incrementally, so peak ≈ resident. Ignore any tool's cumulative "Peak memory" line; it counts a high-water mark of freed transients.

Update 2026-09-01 — re-download model.py if you pulled this before. Earlier builds shipped a model.py that imported a module which only existed in our development environment. On a normal install this artifact either could not generate at all, or fell back to reconstructing every weight matrix on each token — 0.7 tok/s instead of 18.6. Two new fused kernels fix the fallback; prefill improved as well.

Weights are byte-for-byte unchanged, the quantization is untouched, and no score in this card is affected — scoring uses the long-input path, which is unchanged. Decode changed toward higher numerical accuracy, so generated text will differ slightly from earlier runs.

Run it

Requires a Mac with Apple Silicon (macOS, MLX).

With Knurlogic, which works out the settings and checks the model fits before loading it:

pip install knurlogic
hf download TheDrainFlorist/Qwen3.8-27B-VQ-3.9bpw --local-dir ~/Knurlogic/Models/Qwen3.8-27B-VQ-3.9bpw
knurlogic serve ~/Knurlogic/Models/Qwen3.8-27B-VQ-3.9bpw

Chat at http://127.0.0.1:8080/, or point any OpenAI-, Anthropic- or Ollama-compatible client at it (model local). knurlogic ui opens a page with a Launch button for every model on disk instead.

Images work through Knurlogic directly; mlx-vlm is not needed.

The VQ runtime ships inside this repo as model.py (declared by model_file in config.json), and Knurlogic runs the file the model ships.

Without Knurlogic:

pip install 'mlx-lm>=0.31.3'
python -m mlx_lm generate \
  --model TheDrainFlorist/Qwen3.8-27B-VQ-3.9bpw \
  --prompt "Explain vector quantization briefly." \
  --max-tokens 512

Methodology

Vector quantization of the dense MLP trio at d=4, K=4096. Each 4-weight subvector stores one 12-bit index into a per-tensor 4096-entry fp16 codebook. With an fp16 scale per (row, 64 weights) that comes to 3.25 bits per weight over the quantized surface; everything else in the model is 8-bit.

Every quantized tensor uses this one geometry: no depth schedule, no mixed allocation.

Codebooks are fit in pure weight space — k-means over the weight subvectors, no Hessian, no activation statistics, no calibration corpus.

The fit is not seeded. k-means draws an unseeded subsample, so this artifact is reproducible in recipe and geometry but not bit-for-bit. Margins are therefore quoted against a measured fit-to-fit floor rather than against a repeated build; on this family that floor is 2.085 millinats.

Verification

Every tensor was decoded from the published artifact and compared against the bf16 source; no tensor exceeds 3x the artifact's own median reconstruction error. The bundled runtime is exercised as the executing copy in a venv with stock mlx-lm and none of our modules installed — the check that the pre-2026-09-01 model.py defect escaped, because it had been run in a development environment where the missing module happened to exist. Vision tower grafted from the base checkpoint and verified key-for-key against the official index, including the channels-last patch-embedding layout that a naive rename gets silently wrong.

Limitations

• Perplexity cannot rank builds on this family — see above.
• No task-suite scores for this artifact.
• The affine comparators are our own conversions, not community builds.
• Above ≈5 bpw affine wins outright on this model; this collection stops below that line deliberately.

Paper

The method, the full model ladder, the negative results, and the measurement rules behind every number here: Data-Free Vector Quantization Beats Affine Quantization at Matched Bytes Below 6 Bits (CC BY 4.0) · code: VQLab · web version: Space

Support this work

VQLab and these artifacts are built and released independently — the fits, the measurement harness and the published rungs are one person's compute and time. If they are useful to you:

• Sponsor: github.com/sponsors/noahzelezny
• Contract work: available for quantization and on-device inference work on Apple silicon — custom rungs, per-layer allocation for your model, or getting a checkpoint to run well on a Mac. Contact: [email protected]

Provenance

Base model: Qwen/Qwen3.8-27B — Apache-2.0. This is a quantized derivative and inherits that license; using it means accepting the base model's terms. Quantization: TheDrainFlorist, 2026.

Built with MLX and VQLab.