majentik commited on
Commit
f2d00ab
·
verified ·
1 Parent(s): 1785a33

docs: Tier 2 polish — variant matrix + quant trade-off

Browse files
Files changed (1) hide show
  1. README.md +28 -0
README.md CHANGED
@@ -108,3 +108,31 @@ MERaLiON-2 supports speech recognition in Southeast Asian languages including En
108
  - [majentik/MERaLiON-2-3B-RotorQuant-MLX-2bit](https://huggingface.co/majentik/MERaLiON-2-3B-RotorQuant-MLX-2bit) -- RotorQuant 2-bit (smaller)
109
  - [majentik/MERaLiON-2-10B-RotorQuant-MLX-4bit](https://huggingface.co/majentik/MERaLiON-2-10B-RotorQuant-MLX-4bit) -- 10B RotorQuant 4-bit (larger model)
110
  - [aisingapore/MERaLiON-AudioLLM-Whisper-SEA-LION-V3-3B](https://huggingface.co/aisingapore/MERaLiON-AudioLLM-Whisper-SEA-LION-V3-3B) -- Original base model
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
108
  - [majentik/MERaLiON-2-3B-RotorQuant-MLX-2bit](https://huggingface.co/majentik/MERaLiON-2-3B-RotorQuant-MLX-2bit) -- RotorQuant 2-bit (smaller)
109
  - [majentik/MERaLiON-2-10B-RotorQuant-MLX-4bit](https://huggingface.co/majentik/MERaLiON-2-10B-RotorQuant-MLX-4bit) -- 10B RotorQuant 4-bit (larger model)
110
  - [aisingapore/MERaLiON-AudioLLM-Whisper-SEA-LION-V3-3B](https://huggingface.co/aisingapore/MERaLiON-AudioLLM-Whisper-SEA-LION-V3-3B) -- Original base model
111
+
112
+ ## Quant trade-off (MLX lane)
113
+
114
+ | Bits | Approx size | Use case | Recommendation |
115
+ |---|---|---|---|
116
+ | 2-bit | ~799 MB | Aggressive quantization | Very low-RAM Macs |
117
+ | 3-bit | ~1.1 GB | Lossy but small | Low-RAM Macs |
118
+ | **4-bit** | ~1.3 GB | Balanced default | **Recommended for most Macs** |
119
+ | 5-bit | ~1.5 GB | Higher fidelity | Quality-sensitive |
120
+ | 6-bit | ~1.8 GB | Approaching FP16 quality | High-fidelity |
121
+ | 8-bit | ~2.3 GB | Near-lossless reference | Fidelity-critical work |
122
+
123
+ (Current variant — **4bit** — is bolded.)
124
+
125
+ ## Variants in this family
126
+
127
+ (Showing 8 sibling variants under `majentik/meralion2-3b-*`. The current variant — `RotorQuant-MLX-4bit` — is **bolded**.)
128
+
129
+ | Variant | Runtime | Approx size | Use case |
130
+ |---|---|---|---|
131
+ | [RotorQuant](https://huggingface.co/majentik/meralion2-3b-rotorquant) | runtime modifier | n/a | KV-cache root (weight-agnostic) |
132
+ | [RotorQuant-MLX-2bit](https://huggingface.co/majentik/meralion2-3b-rotorquant-mlx-2bit) | mlx-lm | ~983 MB | Apple Silicon, smallest |
133
+ | **RotorQuant-MLX-4bit** | mlx-lm | ~1.9 GB | Apple Silicon balanced |
134
+ | [RotorQuant-MLX-8bit](https://huggingface.co/majentik/meralion2-3b-rotorquant-mlx-8bit) | mlx-lm | ~3.5 GB | Apple Silicon reference |
135
+ | [TurboQuant](https://huggingface.co/majentik/meralion2-3b-turboquant) | runtime modifier | n/a | KV-cache root (weight-agnostic) |
136
+ | [TurboQuant-MLX-2bit](https://huggingface.co/majentik/meralion2-3b-turboquant-mlx-2bit) | mlx-lm | ~983 MB | Apple Silicon, smallest |
137
+ | [TurboQuant-MLX-4bit](https://huggingface.co/majentik/meralion2-3b-turboquant-mlx-4bit) | mlx-lm | ~1.9 GB | Apple Silicon balanced |
138
+ | [TurboQuant-MLX-8bit](https://huggingface.co/majentik/meralion2-3b-turboquant-mlx-8bit) | mlx-lm | ~3.5 GB | Apple Silicon reference |