daniel042310/Minimax-H3-ComfyUI

MiniMax H3 LoRAs for ComfyUI

Experimental LoRAs for MiniMax H3, packaged for ComfyUI and tested mainly with the ref2va weights.

These are research models, not finished tools. Results vary substantially with the source clip, resolution, prompt and reference images.

Models

Model	Purpose	Trigger	Documentation	Workflow
minimax_h3_lms_v1.0_r64	Sharpness/detail enhancement using an aligned source-video guide	Fixed enhancement caption	LMS / Sharpness guide	minimax_h3_lms_workflow.json
minimax_h3_style_transfer_v1.0_r64	Transfer a visual style from an image or text description onto a video	style_transfer:	Style Transfer guide	minimax_h3_style_transfer_workflow.json
minimax_h3_vfx_edit_v1.0_r128	General prompt-directed VFX editing with an aligned source video	vfx_edit:	VFX Edit guide	minimax_h3_vfxedit_wokflow.json
minimax_h3_vfx_edit_v1.0_r128_ffp	Higher-resolution VFX Edit version with experimental first-frame propagation	vfx_edit:	VFX Edit and FFP guide	minimax_h3_vfxedit_wokflow.json
minimax_h3_head_swap_v1.0_r32	Experimental reference-image head replacement over an aligned source video	head_swap:	Head Swap guide and prompt template	minimax_h3_head_swap_workflow.json
minimax_h3_character_swap_v1.0_ref2va_r64_gl	Replace the main guide subject with the character in a reference image while following the guide performance	body_swap:	Character Swap guide and examples	minimax_h3_character_swap_workflow.json
minimax_h3_live_wallpaper_v1.0_ref2va_r32	Animate one to three reference images; often more faithful to facial features, but with less predictable camera behavior	live_wallpaper:	Live Wallpaper guide	minimax_h3_live_wallpaper_workflow.json
minimax_h3_live_wallpaper_v1.0_ref2va_r64	Camera-aware continuation of R32 for prompt-directed camera behavior and temporal reference frames	live_wallpaper:	Live Wallpaper guide	minimax_h3_live_wallpaper_workflow.json

Latent Upscaler

h3_upscaler_lms_v0.1 is the recommended FP16 release of an experimental latent-upscaler checkpoint. It was trained for 2,000 steps with the same sharpness dataset used for the LMS LoRA and initialized from the LBH-123-AI/Minimax_h3_latent_Upscaler project and its minimax_h3_latent_upscaler_3d_fp16.safetensors checkpoint.

See the Latent Upscaler guide for setup, scope and limitations.

Common setup

Place LoRAs in ComfyUI/models/loras/. The included workflows list their required models and custom nodes inside the graph. Keep the output aspect ratio matched to the source clip and use an H3-supported frame count (17n + 5: 5, 22, 39, 56, 73, 90, 107, 124, ...).

The LMS, Style Transfer, VFX Edit and Head Swap models use an aligned source-video guide through MiniMaxH3AddGuide at frame_idx = 0. This is different from a native image/video reference: the guide shares the generated video's spatial and temporal grid.

License and credits

Licenses are specified by asset. The separate Character Swap license applies only to the two Character Swap LoRA weight files listed in LICENSES.md; it does not apply to the other LoRAs, workflows, docs, or examples. Use of the Character Swap LoRA, including commercial use in videos and films, requires no prior permission. Organizations with over US $1,000,000 in annual gross revenue must credit its origin for commercial use. Offering the LoRA as a hosted API, SaaS, or other remote model service is not allowed. See the full license and check each other asset's applicable terms before use.

Base model credit to MiniMaxAI, ComfyUI-ready weights to Comfy-Org, and guide-latent training support to ostris/ai-toolkit and ComfyUI-AIToolkit-MiniMaxH3.