Instructions to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF")# pip install -U transformers accelerate # Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4 # Run inference directly in the terminal: llama cli -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4 # Run inference directly in the terminal: llama cli -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4 # Run inference directly in the terminal: ./build/bin/llama cli -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Use Docker
docker model run hf.co/prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
- Llama new
- LM Studio
- Jan
- vLLM
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
- SGLang
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }' - Ollama
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with Ollama:
ollama run hf.co/prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
- Unsloth Desktop
- Pi
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with Docker Model Runner:
docker model run hf.co/prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
- Lemonade
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Run and chat with the model
lemonade run user.MiniMax-H3-Image-PE-NVFP4-MTP-GGUF-NVFP4
List all available models
lemonade list
- Hermes Agent
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "prithivMLmods/MiniMax-H3-Image-PE-NVFP4-MTP-GGUF:NVFP4" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
MiniMax-H3-Image-PE-NVFP4-MTP-GGUF
MiniMax-H3-Image-PE is MiniMax's prompt-expansion model for its MiniMax-H3-Image image generator. It is fine-tuned from Qwen3.8-27B and released in FP4. It turns a short request into a detailed image description and recommends an aspect ratio, returned as JSON with
expanded_captionandaspect_ratio, with the output constrained to a schema by XGrammar. It runs with thinking on by default (reasoning_effortxhigh, 4,096 max tokens including reasoning), and the reasoning is returned separately. The weights cover text-to-image expansion. For image editing, the release provides only a task prompt and a message-assembly example for a vision-language model of your choice, and the card says editing support is still under development. In editing mode the model describes what is preserved and changed and returns atarget_aspect_ratio. It can be served with SGLang (0.5.23 or later) or run locally through the Modular Diffusers blocks, where the FP4 weights use about 19 GiB of GPU memory. The Diffusers path runs activations in bf16, so its outputs differ slightly from the SGLang deployment. The card gives no benchmarks. The license is the MiniMax-H3-Image Community License Agreement, not Apache 2.0, and some uses need separate written authorization from MiniMax. The Qwen3.8-27B base is Apache 2.0.
MTP β Speculative Decoding: Yes
Multi-Token Prediction (MTP) GGUF is a specialized GGUF model file format extension that integrates speculative decoding directly into the model weights to significantly accelerate local inference. Unlike traditional speculative decoding which requires a separate, smaller "draft" model, MTP GGUF files include additional output heads within the main model architecture that predict multiple future tokens in a single forward pass.
Model Files
| File Name | Quant Type | File Size | File Link | Description |
|---|---|---|---|---|
| MiniMax-H3-Image-PE-NVFP4-MTP.gguf | NVFP4 (with MTP) | 17.9 GB | Link | NVFP4 quantization with Multi-Token Prediction (MTP). Highly optimized for NVIDIA Blackwell hardware accelerators (e.g., RTX Pro 6000, RTX 50-series, B200, B300), offering native hardware-accelerated FP4 Tensor Core speeds and faster generation. |
| MiniMax-H3-Image-PE.mmproj.gguf | mmproj | 931 MB | Link | Multimodal projection file. Used for vision/image capabilities. |
Without MTP vs. With MTP Decoding
| Benchmark | Without MTP | With MTP |
|---|---|---|
| Model | MiniMax-H3-Image-PE-NVFP4-GGUF | MiniMax-H3-Image-PE-NVFP4-MTP-GGUF β± |
| File Size | 17 GB | 17.9 GB |
| Average Generation Speed | 74.94 tokens/s | 112.64 tokens/s |
| Speculative Decoding | Disabled | MTP (draft_n_max=2) |
| MTP Tensors | Not Preserved | Preserved |
| Test Runs | 5 | 5 |
Performance Improvement
| Metric | Result |
|---|---|
| Speed Improvement | +37.70 tokens/s |
| Relative Performance Gain | +50.3% |
| Generation Speed Multiplier | 1.50Γ |
MTP speculative decoding delivers approximately 50.3% faster generation, increasing throughput from 74.94 to 112.64 tokens/s across five benchmark runs.
NVFP4 Test Run
Tested MiniMax-H3-Image-PE-NVFP4-MTP.gguf on an NVIDIA RTX PRO 6000 Blackwell Server Edition GPU with 96 GB of VRAM, using llama-cli with full GPU offloading and MTP speculative decoding.
Performance Metrics
| Metric | Value |
|---|---|
| Average Prompt Processing Speed | 307.96 tokens/s |
| Average Generation Speed | 112.64 tokens/s |
| Total Wall Time | 66.0 seconds |
| Context Length | 8,192 tokens |
| KV Cache (K) | q8_0 |
| GPU | NVIDIA RTX PRO 6000 Blackwell Server Edition |
| GPU VRAM Capacity | 96 GB |
| Peak GPU VRAM Usage | 16.34 GiB |
| Peak GPU Utilization | 95% |
| GPU Layers Offloaded | 99 (-ngl 99) |
| Random Seed | 42 |
| Speculative Decoding | MTP (draft_n_max=2) |
| Test Runs | 5 |
Test Shots
| Shot | Test |
|---|---|
| Shot 1 | Image Edit: Day to Cyberpunk Night |
| Shot 2 | Image Edit: Studio Product Relighting |
| Shot 3 | Image Edit: Summer to Winter Wonderland |
| Shot 4 | Image Edit: Vintage 1970s Film Portrait |
| Shot 5 | Image Edit: Watercolor Painting Restyle |
Run Inference
./build/bin/llama-cli \
-m /path/to/models/MiniMax-H3-Image-PE-NVFP4-MTP.gguf \
--spec-type draft-mtp \
--spec-draft-n-max 2 \
-ngl 99 \
-c 8192 \
--cache-type-k q8_0 \
--seed 42 \
-n 8192 \
-st \
-p "Your prompt here"
Performance results reflect this specific hardware and inference configuration. Actual throughput may vary depending on the prompt, model, software build, and runtime settings.
Snapshots (5)
llama.cpp
LLM inference in C/C++ β https://github.com/ggml-org/llama.cpp
MTP-repackaged and quantized using llama.cpp by β prithivMLmods.
- Downloads last month
- -
4-bit





