README.md

---
license: other
license_name: minimax-m2.7-non-commercial
license_link: LICENSE
library_name: mlx
tags:
- mlx
- jang
- minimax
- moe
- apple-silicon
pipeline_tag: text-generation
---

> **⚠️ Requires [MLX Studio](https://mlxstudio.com) to run.** Standard `mlx_lm` cannot load mixed-precision JANG models. MLX Studio includes the JANG loader with automatic per-layer bit detection.
>
> Follow us: [X @dealignai](https://x.com/dealignai)



<p align="center">
  <img src="mlx-studio-logo.png" alt="MLX Studio" width="400"/>
</p>

<p align="center">
  <img src="jangq-logo.png" alt="JANGQ" width="200"/>
</p>

<div align="center">

# MiniMax-M2.7 JANG_3L

**MiniMax M2.7 228B MoE — 3.08-bit mixed precision, 89 GB**

Best balance of quality and size — fits on 128 GB+ Macs.
</div>

> **Recommended: Run in [MLX Studio](https://mlxstudio.com)** for best experience including thinking mode support and optimized MoE inference.

## Important Settings

MiniMax M2.7 is an always-reasoning model. It thinks before answering on every prompt.

| Setting | Value | Notes |
|---------|-------|-------|
| Temperature | **1.0** | REQUIRED — greedy/temp=0 causes infinite thinking loops |
| Top P | 0.95 | |
| Top K | 40 | |
| Repetition Penalty | 1.1 | Optional, helps prevent loops |

## Model Details

| Metric | Value |
|--------|-------|
| Source | `MiniMaxAI/MiniMax-M2.7` (FP8 E4M3) |
| Architecture | MoE (256 experts, top-8 active), GQA (48 heads / 8 KV), partial RoPE |
| Total Parameters | 228.7B |
| Active Parameters | ~1.4B per token |
| Profile | JANG_3L (CRITICAL=8-bit, IMPORTANT=4-bit, COMPRESS=3-bit) |
| Actual avg bits | 3.08 |
| Model size | 89 GB |
| Format | JANG v2 (MLX-native safetensors, instant load) |
| group_size | 128 (speed-optimized for 256 experts) |
| Routing | Sigmoid + bias correction (not softmax) |
| QK-norm | Full vector RMSNorm |
| Context | 192K tokens |

## JANG_3L Bit Allocation

| Tier | Components | Bits |
|------|-----------|------|
| CRITICAL | Attention (Q/K/V/O), lm_head | 8 |
| IMPORTANT | Embeddings | 4 |
| COMPRESS | Expert MLP (w1/w2/w3) — 98%+ of params | 3 |
| Passthrough | MoE router/gate (float16), norms, QK-norms | 16 |

JANG protects routing and attention at full precision while compressing the 256 expert MLPs — where MoE models are most tolerant of quantization. The router is kept at float16 (no quantization) for maximum routing precision.

## MMLU Comparison — All JANG Profiles (200q, reasoning ON)

| Subject | JANG_2L (63 GB) | JANG_3L (89 GB) | JANG_4M (115 GB) | JANG_6M (167 GB) |
|---------|:-:|:-:|:-:|:-:|
| Abstract Algebra | 16/20 | 19/20 | 19/20 | — |
| Anatomy | 17/20 | 18/20 | **20/20** | — |
| Astronomy | 19/20 | 19/20 | 19/20 | — |
| College CS | 17/20 | 19/20 | 19/20 | — |
| College Physics | 16/20 | **20/20** | **20/20** | — |
| HS Biology | 19/20 | **20/20** | 19/20 | — |
| HS Chemistry | 16/20 | 19/20 | 19/20 | — |
| HS Mathematics | 18/20 | **20/20** | **20/20** | — |
| Logical Fallacies | 19/20 | 19/20 | 18/20 | — |
| World Religions | 19/20 | 18/20 | 18/20 | — |
| **TOTAL** | **176/200 (88.0%)** | **191/200 (95.5%)** | **191/200 (95.5%)** | **≥95.5%** |
| **GPU RAM** | **62.6 GB** | **88.6 GB** | **114.8 GB** | **167.2 GB** |

JANG_6M not benchmarked due to slow generation (~20 tok/s). Near-lossless 6-bit expected to match or exceed 4M/3L.

## Why JANG for MiniMax

Standard MLX quantization on MiniMax produces **completely broken output at ALL bit levels** (~25% MMLU = random guessing). JANG's mixed-precision approach is the **only working quantized MiniMax on Apple Silicon**.

On M2.5, JANG_2L achieved **74% MMLU** vs MLX's 25% (random). M2.7 results pending.

## All Quantizations

| Model | Profile | Size | Avg Bits |
|-------|---------|------|----------|
| [JANG_2L](https://huggingface.co/JANGQ-AI/MiniMax-M2.7-JANG_2L) | (8, 6, 2) | 63 GB | 2.10 |
| [JANG_3L](https://huggingface.co/JANGQ-AI/MiniMax-M2.7-JANG_3L) | (8, 4, 3) | 89 GB | 3.08 |
| [JANG_4M](https://huggingface.co/JANGQ-AI/MiniMax-M2.7-JANG_4M) | (8, 4, 4) | 115 GB | 4.06 |
| [JANG_6M](https://huggingface.co/JANGQ-AI/MiniMax-M2.7-JANG_6M) | (8, 6, 6) | 167 GB | 6.03 |

## Requirements

- Apple Silicon Mac with 128 GB unified memory
- MLX framework
- [MLX Studio](https://mlxstudio.com) recommended

## Tool Use / Agent Mode

MiniMax M2.7 uses **interleaved thinking + tool calls** — it reasons inside `<think>` blocks, then emits tool calls in `<minimax:tool_call>` format. Some clients (Opencode, etc.) may strip the `<think>` block and miss the tool call.

**For tool-use clients**, set `enable_thinking=False` in the chat template:

```python
text = tokenizer.apply_chat_template(
    messages, tokenize=False, add_generation_prompt=True,
    enable_thinking=False  # skips <think> injection for tool-use
)
```

MiniMax tool call format:
```xml
<minimax:tool_call>
<invoke name="tool_name">
<parameter name="param1">value1</parameter>
</invoke>
</minimax:tool_call>
```

## Usage

```python
from jang_tools.loader import load_jang_model
from mlx_lm import generate
from mlx_lm.sample_utils import make_sampler

model, tokenizer = load_jang_model("JANGQ-AI/MiniMax-M2.7-JANG_3L")
sampler = make_sampler(temp=1.0, top_p=0.95)

prompt = tokenizer.apply_chat_template(
    [{"role": "user", "content": "What is photosynthesis?"}],
    tokenize=False, add_generation_prompt=True
)
output = generate(model, tokenizer, prompt=prompt, max_tokens=2048, sampler=sampler)
print(output)
```

---

## Support

[MLX Studio](https://mlxstudio.com) | [JANGQ](https://jangq.ai) | [X @dealignai](https://x.com/dealignai)

Quantized by Jinho Jang (eric@jangq.ai) using JANG Tools v2.4.1.

---

*This model is licensed under the MiniMax M2.7 Non-Commercial License. Commercial use requires prior written authorization from MiniMax (api@minimax.io). See LICENSE file for full terms.*