Luisacaotica / ComfyUI-MiniMaxH3Mod
git clone https://github.com/Luisacaotica/ComfyUI-MiniMaxH3Mod.git
v0.2.6 Β· 1mo ago
π§ Under construction β no-training RefMod reference adapters for MiniMax H3 (compress reference images/videos into tiny latents, no training needed).
+8
stars, 24h Β· #1,696
+~56
stars, 7 days Β· #2,142
+~240
stars, 30 days Β· #2,137
552
β
total Β· +12% this week
63
forks Β· 9 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2026-08-15 (2mo ago)
Last push7d ago
Watchers9
OwnerUser
GitHub topics
Links
README excerpt
*Update: https://github.com/Luisacaotica/ComfyUI-MiniMaxH3Mod/discussions/36 # ComfyUI-MiniMaxH3Mod - Changing the F#cking world with cigarretes and coffe. > π§ **Under construction** β API and node schemas are still evolving. Mods > stay compatible, but expect node names/inputs to shift between versions. ## What's new β v0.2.6 - **Standalone creators** β Create H3 RefMod and Master now run without a downstream output node. Both return a `details` string with token counts and saved paths. `save=False` still produces an in-memory bundle without files. - **Different-size masks** β route a MASK list through **Collect H3 RefMod Masks** into the creator's `mask_list` input. Each mask retains its dimensions until it is resized/cropped with its corresponding reference. The collector consumes the list once, avoiding one extraction per list item. Use `mask` or `mask_list`; one mask broadcasts, otherwise provide one per reference in image-slot, video-slot, then folder-bundle order. Existing MASK batches work as before. Pixels cropped by an upstream batch node cannot be recovered. - **Full Reference video sampling** β choose a causal frame count before sampling, so frame limits such as 16 no longer drop the end of the clip. - **Compact additive loaders** β Loader and Axis start with one visible slot. Use **+ Add RefMod** to reveal more, up to the existing eight slots. Each reference's controls stay together; connected slots are protected from removal. - **Single-file visual + audio bundles** β Master can save both modalities in one `.safetensors` with `save_layout=bundle`. **Save H3 RefMod Bundle** also packs existing references without running extraction again. - **Independent loader controls** β each Loader/Axis slot offers **All / Visual / Audio**, plus visual and audio strengths. Excluded modalities and modalities with strength zero are not loaded. Existing standalone files remain supported. - **Bundle-aware library and Config** β find combined files in the library and edit selected components without dropping the other contents. This is a storage and selection update. It does not fix voice identity or enforce audiovisual synchronization. See single-file bundles. ### v0.2.5 and subsequent fixes On `main` after v0.2.5: **Refresh RefMods** updates the current Loader/Axis dropdowns from the RefMod folders without refreshing all ComfyUI models. Selections and connected inputs are preserved. The library's Refresh also updates that loader's dropdowns. - **Clearer creation controls** β Create node titles, Full/Compressed Reference modes and Refinement Steps; old workflows remain accepted. - **Explicit visual budget policy** β choose truncate or error before saving, including Master. - **Compatibility fixes** β projected ClipProj encoders and batched H3 VAE decoding in Text Encode. - **Full visual inspection** β optional full-video preview, with a lightweight first-frame default. Since v0.2.0: extraction widgets accept token budgets above 65,536