joeygambino
MiniMax-H3-encoder
Other use
- Parameters
- 32.8B
- Max context length
- 262,144
- Architecture
- qwen3vl
- License
- Conditional
- Base model
- MiniMaxAI/MiniMax-H3
- llama.cpp
- b6887+
About MiniMax-H3-encoder
MiniMax-H3-encoder is a GGUF model based on MiniMaxAI/MiniMax-H3 on Hugging Face. GGUF files are published by joeygambino/MiniMax-H3-encoder-GGUF. It has about 32.8B parameters, the qwen3vl architecture, a maximum context length of 262,144 tokens (values written in the GGUF).
There are 2 quantizations, with file sizes from 19.8 GB (Q4_K_M) to 23.2 GB (Q5_K_M) (actual sizes on Hugging Face).
Running Q4_K_M (19.8 GB) with an 8,192-token context needs an estimated 23.0 GB of memory, and an estimated 29.4 GB at 32,768 tokens. For 8,192 tokens, a GPU with 24 GB or more of VRAM (such as GeForce RTX 3090 Ti, GeForce RTX 4090), or a Mac with 24 GB or more of unified memory, is a rough guide (macOS caps how much memory the GPU can use, so leave some headroom).
The original model is licensed under MiniMax H3 Community License Agreement, which allows commercial use with conditions such as scale or purpose. Check the original license for the terms of use. An mmproj file for image input is also available.
File size and estimated memory per quantization
- Up to 8 GB
- Up to 16 GB
- Up to 24 GB
- Up to 48 GB
- Up to 128 GB
- More
File sizes are the actual values on Hugging Face. Memory is estimated for each context length (KV cache f16). The formula is in How memory is calculated.
All memory figures are Estimated (KV cache f16). It should run on a setup with at least this much VRAM (or Mac unified memory). Click a value to see the devices and models that fit that amount (Find by GPU / Mac).
Using image input: This model supports image input. To use images, an mmproj file is loaded as well.
About the "quality guide" (how far a quantization drifts from the original)
For each quantization type, how far the output drifts from the original model, grouped into six levels from values llama.cpp measured on Llama-3-8B.
The value is mean KLD (the difference between the original and quantized model in next-token probabilities); smaller means closer to the original. Quantizations made with an imatrix (importance data) come out slightly smaller. Levels use the value without an imatrix (or with one, for types that only have that).
These values were not measured on this model. Larger models and MoE models tend to drift less with the same type. Distributor-specific mixed types (such as UD-Q4_K_XL) cannot be matched by type name alone, so they show "-".
| Quantization | Quality guide | KLD (no imatrix) | KLD (imatrix) | Size (Llama-3-8B) |
|---|---|---|---|---|
| Q8_0 | Nearly identical | 0.0014 | - | 7.96 GiB |
| Q6_K | Very small | 0.0055 | - | 6.14 GiB |
| Q5_K_M | Very small | 0.0108 | - | 5.33 GiB |
| Q5_K_S | Small | 0.0166 | - | 5.21 GiB |
| Q5_1 | Small | 0.0180 | - | 5.65 GiB |
| Q5_0 | Small | 0.0222 | - | 5.21 GiB |
| Q4_K_M | Small | 0.0313 | 0.0282 | 4.58 GiB |
| Q4_K_S | Medium | 0.0431 | 0.0320 | 4.37 GiB |
| IQ4_NL | Small | - | 0.0357 | 4.35 GiB |
| IQ4_XS | Small | - | 0.0363 | 4.14 GiB |
| Q4_1 | Medium | 0.0717 | - | 4.78 GiB |
| Q4_0 | Medium | 0.0719 | - | 4.34 GiB |
| Q3_K_L | Medium | 0.0872 | 0.0731 | 4.03 GiB |
| Q3_K_M | Medium | 0.1019 | 0.0844 | 3.74 GiB |
| IQ3_M | Medium | - | 0.1025 | 3.53 GiB |
| IQ3_S | Medium | - | 0.1113 | 3.42 GiB |
| IQ3_XS | Large | - | 0.1387 | 3.28 GiB |
| IQ3_XXS | Large | - | 0.1836 | 3.05 GiB |
| Q3_K_S | Large | 0.2282 | 0.1998 | 3.41 GiB |
| IQ2_M | Large | - | 0.3260 | 2.74 GiB |
| Q2_K | Very large | 0.4451 | 0.3322 | 2.96 GiB |
| Q2_K_S | Very large | - | 0.4034 | 2.96 GiB |
| IQ2_S | Very large | - | 0.4392 | 2.56 GiB |
| IQ2_XS | Very large | - | 0.5463 | 2.43 GiB |
| IQ2_XXS | Very large | - | 0.8120 | 2.24 GiB |
| IQ1_M | Very large | - | 1.3931 | 2.01 GiB |
| IQ1_S | Very large | - | 2.2546 | 1.88 GiB |
Source: llama.cpp (MIT), measured on Llama-3-8B against FP16, Wikitext-2, revision f364eb6f. Original table · Reading and choosing quantizations
GGUF source
joeygambino/MiniMax-H3-encoder-GGUF
Published by the original developer About this label
Last checked: Nov 11, 2026
- Architecture
- qwen3vl
- llama.cpp b6887 and later
- Parameters
- 32.8B
- Max context length
- 262,144
- License
- minimax-h3-community-license-agreement Conditional
| Quantization | File size Measured | Quality guide | 4,096 | 8,192 | 16,384 | 32,768 | 65,536 | 131,072 | 262,144 max |
|---|---|---|---|---|---|---|---|---|---|
| Q4_K_M | 19.8 GB | Small | 21.9 GB | 23.0 GB | 25.1 GB | 29.4 GB | 38.0 GB | 55.2 GB | 89.6 GB |
| Q5_K_M | 23.2 GB | Very small | 25.4 GB | 26.4 GB | 28.6 GB | 32.9 GB | 41.5 GB | 58.6 GB | 93.0 GB |
The mmproj file for image input (F16) is 1.20 GB Measured . It is not included in the memory above, so add it if you use images.
Ollama ollama run hf.co/joeygambino/MiniMax-H3-encoder-GGUF:Q4_K_M
llama.cpp llama-server -hf joeygambino/MiniMax-H3-encoder-GGUF:Q4_K_M
Generation speed on common GPUs and Macs (estimated)
A rough guide to how fast Q4_K_M (19.8 GB) generates text. Each token reads the model weights once, so the upper limit is memory bandwidth ÷ file size. The guide is 60–80% of that, where most published measurements fall.
| Device | Memory bandwidth | Guide (tokens/s) Estimated | Upper limit |
|---|---|---|---|
| GeForce RTX 3090 24 GB | 936 GB/s | 28–38 | 47 |
| GeForce RTX 4090 24 GB | 1,008 GB/s | 31–41 | 51 |
| GeForce RTX 5090 32 GB | 1,792 GB/s | 54–73 | 91 |
| Apple M4 32 GB | 120 GB/s | 3.6–4.9 | 6.1 |
| Apple M4 Pro 48 GB | 273 GB/s | 8.3–11 | 14 |
| Apple M5 Ultra 96 GB | 1,200 GB/s | 36–49 | 61 |
Estimates only. Prompt processing speed (limited by compute) is not included. Longer contexts and offloading part of the model to the CPU make it slower. Macs are shown only when installed memory is at least 4/3 of what is needed. Devices without published bandwidth (some GeForce cards, etc.) are not shown.
License and commercial use
MiniMax H3 Community License Agreement Conditional
The license is limited by region: it covers the world excluding the EU, the UK, South Korea and the United States, and use, copying, modification, distribution or display outside that territory is not authorized (contact MiniMax if you want to deploy in an excluded territory). If a commercial product or service earns more than US$20 million a year, you need prior written authorization, and you must prominently display "MiniMax H3" in the interface. You may not use the model or its outputs to improve other AI models, you must follow the Acceptable Use Policy, and you must bind users to the same restrictions.
Based on the license on the original model's Hugging Face page. Original license text (checked Nov 1, 2026)
The summary states facts this site read from the original text and is not legal advice. Always check the original license and its latest terms before use. All licenses
How to run
Mainline llama.cpp can load this model's format (qwen3vl) from b6887 (Oct 30, 2025) onward. Ollama and LM Studio bundle llama.cpp internally, so an older app fails to load it with errors such as "unknown model architecture". If that happens, update the app.
Example commands using Q4_K_M. To use another quantization, replace the name with one from the table above. How to run local LLMs
Ollama
Run it by pointing directly at the GGUF on Hugging Face.
ollama run hf.co/joeygambino/MiniMax-H3-encoder-GGUF:Q4_K_M
llama.cpp
Pass the repository and quantization name to llama-server (or llama-cli) with -hf.
llama-server -hf joeygambino/MiniMax-H3-encoder-GGUF:Q4_K_M
LM Studio
Paste joeygambino/MiniMax-H3-encoder-GGUF into the search box, download it, and choose the quantization from the file list.
Models of a similar size (other developers)
-
27.3B
Qwen
Qwen3.8-27B
- UD-Q4_K_M size
- 16.5 GB
- Memory at 8K
- 18.2 GB
Measured Estimated VRAM 24 GB+
-
35.5B
huihui-ai
Huihui-Qwen3.6-35B-A3B-abliterated-MTP
- Q2_K size
- 13.2 GB
- Memory at 8K
- 14.5 GB
Measured Estimated VRAM 16 GB+
-
35.5B
ornith-ai
Ornith-1.5-35B-A3B
- Q4_K_M size
- 21.7 GB
- Memory at 8K
- 23.0 GB
Measured Estimated VRAM 24 GB+
-
27.3B
huihui-ai
Huihui-Qwen3.8-27B-abliterated
- Q4_K_M size
- 16.6 GB
- Memory at 8K
- 18.3 GB
Measured Estimated VRAM 24 GB+
-
25.2B
farbodtavakkoli
OTel-2.0-Decision-26B-A4B-4bit
- Q4_K_M size
- 16.8 GB
- Memory at 8K
- 18.4 GB
Measured Estimated VRAM 24 GB+
-
27.3B
JonathanColetti
Qwen3.8-27B-Uncensored
- Q4_K_M size
- 16.5 GB
- Memory at 8K
- 18.3 GB
Measured Estimated VRAM 24 GB+
Frequently asked questions
- How much memory do I need to run MiniMax-H3-encoder (Q4_K_M)?
- The file size is 19.8 GB (measured). With a 8,192-token context, the estimated memory including the KV cache is 23.0 GB. The formula is published at https://localllm.az-arte.com/en/guide/memory-calculation.
- Can MiniMax-H3-encoder be used commercially?
- The original model's license is MiniMax H3 Community License Agreement (Commercial use with conditions).The license is limited by region: it covers the world excluding the EU, the UK, South Korea and the United States, and use, copying, modification, distribution or display outside that territory is not authorized (contact MiniMax if you want to deploy in an excluded territory). If a commercial product or service earns more than US$20 million a year, you need prior written authorization, and you must prominently display "MiniMax H3" in the interface. You may not use the model or its outputs to improve other AI models, you must follow the Acceptable Use Policy, and you must bind users to the same restrictions. Check the original license text before deciding.
- Does MiniMax-H3-encoder run in 8 GB, 12 GB, 16 GB or 24 GB of VRAM?
- 8 GB: no quantization fits; 12 GB: no quantization fits; 16 GB: no quantization fits; 24 GB: up to Q4_K_M (est. 23.0 GB) (estimated at 8,192 tokens with an f16 KV cache, files from the most-downloaded source).
- What is the command to run MiniMax-H3-encoder with Ollama?
- Run "ollama run hf.co/joeygambino/MiniMax-H3-encoder-GGUF:Q4_K_M" to use the GGUF on Hugging Face directly. To use another quantization, replace the name at the end.