This is a 4-bit MLX quantization of JetBrains/Mellum2-12B-A2.5B-Thinking, the reasoning-augmented Mixture-of-Experts coding assistant from JetBrains. It is derived from the full-precision jedisct1/Mellum2-12B-A2.5B-Thinking-mlx conversion.

Mellum 2 uses 64 experts with 8 active per token (about 2.5B active parameters out of 12B), a mix of sliding-window and full-attention layers, and a 131,072-token context window. It emits its reasoning inside <think>...</think> blocks before the final answer.

A naive flat 4-bit quantization of this model breaks tool calling. In testing, the model would emit edit-style tool calls whose JSON arguments contained mis-escaped quotes, so the server dropped them as malformed and agent runs stalled. The culprit was 4-bit precision on the attention and output layers, which is where the model copies literal source text verbatim into a tool argument.

This quantization avoids that. The 64 experts are the overwhelming majority of the weights, so they are quantized to 4 bits to keep the file small, while the parts that govern formatting and routing are kept at 8 bits:

All quantization uses a group size of 64, which works out to about 4.85 bits per weight. The disk footprint is the same as a flat 4-bit model, but tool calling holds up.

Tool calling was verified end to end against a live mlx_lm.server driven by the swival agent harness: across repeated runs the model issued well-formed read_file, edit_file, write_file, list_files, and shell-command calls, completed multi-step coding tasks, and never produced a malformed tool call. Generation stops cleanly on <|im_end|> (the eos_token_id is set to [0, 28], which is what lets agent harnesses see a proper tool_calls finish reason).

If you want output that matches the original model as closely as possible and can spare the memory, use the 8-bit quantization instead.

The mellum architecture is not supported by the stock mlx-lm code yet.

Until it is supported upstream, install this fork of mlx-lm from source:

Or run it directly with uv:

Quick test:

Starting the server:

The recommended sampling settings from JetBrains are temperature=0.6, top_p=0.95, top_k=20.

Install swival.dev:

Then point it at the running server:

Apache 2.0, inherited from the original model.