MiniMax-H3-Acc-LoRAs-sidecar

MiniMax-H3 acceleration LoRAs for ComfyUI

MiniMax H3 normally takes 16 sampler steps to render a clip with sound. With these files and one ComfyUI node it takes 5 to 8, at close to the same quality. They are conversions of alibaba-pai/MiniMax-H3-Acc-LoRAs, the official Parallel Decoding Distillation LoRAs for MiniMaxAI/MiniMax-H3. Nothing was trained here.

Each file is a sidecar: it rides alongside your H3 checkpoint and carries three things the acceleration needs. A LoRA update for the transformer, an update to the timestep modulation, and a bank of 32 replacement output heads, one per slice of the trajectory, which is the actual trick. A stock LoRA loader applies only the first and silently renders at the wrong quality. The MiniMaxH3PDDLoRA node here applies all three and gives your sampler the schedule the heads were made for. Take the node and the files from the same revision; they are checked against each other.

What changed since the last update

Quick start

1. Read your checkpoint's filename. It says fl2va or ref2va, and it says pruned if it is. That is enough to pick a file below.

2. Put that file in models/loras/.

3. Put the folder comfyui_minimax_h3_pdd/ in custom_nodes/ and restart. Nothing beyond core ComfyUI; you do not need the source repo. If you already run ComfyUI-h3-explorations, you have this node; do not install it twice. If it fails to load with No module named 'pdd_observe', download it again: the first 2026-09-03 copy was incomplete.

   hf download fbjr/MiniMax-H3-Acc-LoRAs-sidecar --include "comfyui_minimax_h3_pdd/*" --local-dir ComfyUI/custom_nodes
   

4. Open a graph from workflows/, or wire the node yourself:

UNETLoader ──► MiniMaxH3PDDLoRA ──MODEL──► BasicGuider ──► SamplerCustomAdvanced
                      └──────────SIGMAS───────────────────────────┘

1. Set steps on the node. 5 is a good default; 8 is the distilled count.

Two rules: no BasicScheduler, wire the node's SIGMAS to the sampler instead, since a scheduler at the same count gives different sigmas than the heads were fused for; and set steps only on the node, which refuses a count it cannot fuse.

Which file

Not sure whether yours is pruned? Take adaln2688; it works on both. The two partitions share identical key sets, which is why each file carries a checkpoint fingerprint: without it a wrong pairing loads with no error.

Steps

The heads were distilled over a 32-point grid in blocks of width 4; a count is legal when its blocks tile the grid at widths 4 to 8.

5 to 8 are a plateau; pick by time. 1, 2, 16 and 32 are accepted but untested; everything else is refused. Different counts give different clips, not better and worse versions of one.

Workflows

Four text-to-video-with-audio graphs on FL2VA, one dialogue scene. Repoint the loaders at your checkpoint and VAEs.

Knobs

Leave everything but steps alone unless you are experimenting.

Versions

Converter 3, regenerated 2026-09-03. The node folder's own README.md names the commit it was built from. Content hashes over sorted metadata and every tensor's bytes in key order:

Under the hood

The published files use diffusers-side key names, so ComfyUI skips every tensor and renders an ordinary undistilled pass that looks like a weak LoRA. The conversion fuses q, k and v into ComfyUI's single projection with alpha scaled to match, renames two modules and swaps the SwiGLU halves, ships the 32 output heads verbatim and fuses them per block at load so one file serves every legal count, and carries the modulation update in full in the adaln2688 files or pre-solved into the pruned checkpoint's rank-8 basis in the others. If you write your own loader: the heads are verbatim, not deltas from head 0, which is the opposite of ComfyUI core's convention.

Limitations

Four steps cannot be improved, since 8, 8, 8, 8 is the only legal layout. Block width 8 is twice the trained width and unmeasured. Coarser steps degrade video and audio together; you hear it first. This is an 8-step distillation, and far from 8 is extrapolation.

Credits

• MiniMax for MiniMax H3.
• alibaba-pai for the Acc LoRAs these are converted from, and for the PDD method.
• The node is generated from ComfyUI-h3-explorations, which is where to file issues and where the rest of the H3 work lives.
• silveroxides, whose ComfyUI-UtilsCollection PDD implementation separates LoRA strength from head strength; the node that reads these files borrows that split.

Powered by MiniMax H3.

---

License

These are Model Derivatives of MiniMax H3 and are distributed under the MiniMax H3 Community License Agreement, the same terms as both upstream releases. The full agreement is in LICENSE; the required attribution is in NOTICE.

Two terms worth reading before you use these commercially or redistribute them, neither of which is unusual but both of which are easy to miss:

• The agreement is territorially limited — worldwide excluding the Excluded Territories it names.
• Commercial products or services generating over 20 million USD in yearly revenue need separate written authorisation from MiniMax.

If you redistribute these files or anything derived from them, the agreement requires you to pass on a copy of it, carry prominent notices on modified files, and include the NOTICE text. You may not relicense them under different terms.

MiniMax H3 is licensed under the MiniMax H3 Community License Agreement,
Copyright (c) 2026 MiniMax. All Rights Reserved.