CoolFace
Modelpublic

Abiray/MiniMax-H3-Pruned-GGUF

sourceHugging Faceotherupdated 2mo agoView on Hugging Face
68likes147kdownloads
Model Card

MiniMax H3 Pruned GGUF

<video controls autoplay loop muted style="width: 100%; border-radius: 8px;" src="https://huggingface.co/Abiray/MiniMax-H3-Pruned-GGUF/resolve/main/video/MiniMaxH300002-audio.mp4"></video>

This repository (Abiray/MiniMax-H3-Pruned-GGUF) provides pruned and quantized GGUF weights for the MiniMax H3 omni-modal generative model. MiniMax H3 is designed for unified multimodal context processing, capable of generating synchronized high-definition video and 32 kHz stereo audio from text, image, audio, and video inputs.


๐ŸŒŸ Key Highlights

  • โ€”VRAM Efficiency: Pruned architecture compressed down to 8.9 GB โ€“ 21.6 GB, bringing MiniMax H3 execution to consumer-tier GPUs.
  • โ€”Synchronized Omni-Modal Output: Simultaneous generation of video (24 FPS) and native stereo audio (32 kHz).
  • โ€”Native ComfyUI Support: Directly compatible with standard ComfyUI-GGUF workflows using the native MiniMax backend.
  • โ€”Dual Pipeline Variants: Full quant suites for both FL2VA (First/Last Frame) and Ref2VA (Omni-Reference) modes.

๐Ÿ“‚ Repository Weights & Quantization Breakdown

Note: For optimal performance, Q4_K_M is recommended for 16 GB GPUs, while Q5_K_M is recommended for GPUs with 24 GB VRAM.

FL2VA Models (First-and-Last-Frame Mode)

QuantizationFile NameSizeTarget Hardware / Use Case
Q3_K_MMiniMax-H3-FL2VA-Pruned-Q3_K_M.gguf8.9 GBLow VRAM (~12 GB GPUs)
Q4_K_MMiniMax-H3-FL2VA-Pruned-Q4_K_M.gguf11.6 GBRecommended Balance (16 GB GPUs)
Q4_K_SMiniMax-H3-FL2VA-Pruned-Q4_K_S.gguf11.6 GBCompact 4-bit K-Quant
Q5_K_MMiniMax-H3-FL2VA-Pruned-Q5_K_M.gguf14.1 GBHigh Quality Balance (24 GB GPUs)
Q5_K_SMiniMax-H3-FL2VA-Pruned-Q5_K_S.gguf14.1 GBCompact 5-bit K-Quant
Q6_KMiniMax-H3-FL2VA-Pruned-Q6_K.gguf16.7 GBNear-Lossless Precision
Q8_0MiniMax-H3-FL2VA-Pruned-Q8_0.gguf21.6 GBMaximum Fidelity / Reference

Ref2VA Models (Omni-Reference Mode)

QuantizationFile NameSizeTarget Hardware / Use Case
Q3_K_MMiniMax-H3-Ref2VA-Pruned-Q3_K_M.gguf8.9 GBLow VRAM (~12 GB GPUs)
Q4_K_MMiniMax-H3-Ref2VA-Pruned-Q4_K_M.gguf11.6 GBRecommended Balance (16 GB GPUs)
Q4_K_SMiniMax-H3-Ref2VA-Pruned-Q4_K_S.gguf11.6 GBCompact 4-bit K-Quant
Q5_K_MMiniMax-H3-Ref2VA-Pruned-Q5_K_M.gguf14.1 GBHigh Quality Balance (24 GB GPUs)
Q5_K_SMiniMax-H3-Ref2VA-Pruned-Q5_K_S.gguf14.1 GBCompact 5-bit K-Quant
Q6_KMiniMax-H3-Ref2VA-Pruned-Q6_K.gguf16.7 GBNear-Lossless Precision
Q8_0MiniMax-H3-Ref2VA-Pruned-Q8_0.gguf21.6 GBMaximum Fidelity / Reference

โš™๏ธ Quickstart & ComfyUI Deployment

Requirements

  • โ€”ComfyUI: Version v0.30.0 or higher is required for native MiniMax-H3 architecture support.
  • โ€”Extension: ComfyUI-GGUF custom node package installed.

Setup Steps

  1. 1.Download your desired .gguf variant from the table above.
  2. 2.Place the downloaded .gguf file into the ComfyUI/models/unet/ directory.
  3. 3.In your ComfyUI workflow, load the model using the `UnetLoaderGGUF` node.

๐Ÿ“‹ Model Variants & Input Specifications

  • โ€”H3-Base-FL2VA (First-and-Last-Frame Mode):
  • โ€”No image input: Operates as standard Text-to-Video / Text-to-Audio-Video.
  • โ€”Single image input: Generates video conditioned on the initial frame or final frame.
  • โ€”Dual image input: Interpolates seamlessly between designated first and last reference frames.
  • โ€”H3-Base-Ref2VA (Omni-Reference Mode):
  • โ€”Images: Up to 9 reference images.
  • โ€”Videos: Up to 3 video clips (2โ€“15 seconds per clip; total combined duration $\le$ 15s).
  • โ€”Audio: Up to 3 audio clips (must be accompanied by visual input; duration 2โ€“15s).
  • โ€”Combined Context: Maximum of 12 multi-modal input assets allowed per prompt.

๐Ÿ“Š Output Specifications

  • โ€”Duration: 4 โ€“ 15 seconds.
  • โ€”Aspect Ratios: Flexible ratio support (16:9, 9:16, 4:3, 3:4, 1:1, 21:9).
  • โ€”Native Resolution: 768p base resolution (scalable to 2K via H3-Regenerate-2K).
  • โ€”Frame Rate: 24 FPS.
  • โ€”Audio Track: 32 kHz stereo audio output.
  • โ€”Multilingual Dialogue: Stable support across 11 primary languages (English, Chinese, French, German, Japanese, Korean, Spanish, Russian, Portuguese, Italian, Arabic).

๐Ÿ“œ Legal & License

MiniMax H3 is released under the MiniMax H3 Community License Agreement. Please refer to the MiniMaxAI/MiniMax-H3 repository and the repository's LICENSE file for full terms and commercial usage guidelines.