DumasNodes
Generic ComfyUI utility nodes under the Dumas brand. MiniMax H3-specific
nodes are grouped under Dumas/MiniMax H3/... so they can be installed
alongside the maintained upstream ComfyUI-H3-Continuum pack without
overriding its node IDs.
Sequential video assembly
Dumas Standalone Video
DumasStandaloneVideo saves both the complete generated clip and a full copy.
For a continuation clip, set reference_frames to the number of frames taken
from the previous clip for continuity. The value is returned as the final
reference_frames output so it can be wired directly into
DumasJoinVideoClips.
Dumas Join Video Clips (No Re-encode)
DumasJoinVideoClips accepts one reference-frame input for each clip. It trims
that many frames from the beginning of any clip whose value is greater than
zero, then concatenates the resulting files with FFmpeg stream copy. This
avoids a full re-encode of the assembled video. Clip 1 normally remains at
zero; continuation clips receive the reference-frame output from their
standalone nodes.
Stream-copy trimming is codec/keyframe-aware: the requested boundary is
converted using the clip's frame rate, but a codec may choose the nearest safe
packet boundary. For exact frame cuts, use the existing complete_clip output
or accept a re-encoded workflow.
Project rendering
MiniMax H3 tiled latent upscale
DumasMMH3TiledLatentUpscale is a thin integration node for the native
MMH3UltimateUpscale node used by the MiniMax-H3 workflow. It accepts the
native H3 latent-upscale, temporal-split, and spatial-split parameter objects,
but creates a separate upscale sampler, scheduler, sigma schedule, noise seed,
denoise value, steps value, and CFG value. The base H3 sampling pass is not
changed.
Typical wiring:
base H3 latent + model + conditioning
-> Dumas MiniMax-H3 Tiled Latent Upscale
H3 Latent Upscale Params --------------------^
H3 Temporal Split Params ---------------------^
H3 Spatial Split Params -----------------------^
The node requires the ComfyUI installation to provide MMH3UltimateUpscale,
RandomNoise, KSamplerSelect, and BasicScheduler. It does not copy or
redistribute the third-party H3 LongVideos implementation. The native node's
current socket types are H3_UPSCALE_PARAM, H3_TEMPORAL_PARAM, and
H3_SPATIAL_PARAM; these are deliberately used unchanged for workflow
compatibility.
DUMAS H3 Sequence Prompt Builder
DumasH3SequencePromptBuilder provides the tabbed, timeline-oriented prompt
editor used for multi-chunk H3 jobs. It emits one absolute sequence prompt,
the chunk count, the shared chunk duration, and a per-chunk reference bundle.
Reference images are inserted as @R1 through @R9; routing is based on the
shared directive, soundscape, music, and each chunk's full prompt text.
The prompt builder intentionally uses the ReferenceImagesV39Bundle class
from the installed upstream H3 Continuum pack. Install that pack alongside
DumasNodes; DumasNodes does not copy or replace the upstream reference-image
implementation.
DUMAS H3 Continuum Tiled Latent Upscale (Per Clip)
DumasH3ContinuumTiledLatentUpscalePerClip applies the native H3 tiled
upscale independently to each physical Continuum clip. It accepts the
Continuum refine_context and uses the upstream refine bridge when no direct
conditioning is connected. Its sampler, scheduler, sigma input, steps,
denoise, CFG, and noise seed are separate from the base generation pass.
Connected sockets take precedence over node defaults. The node preserves one
LATENT list item per physical clip to avoid concatenating a long sequence
into one oversized VRAM allocation.
The CSGlide Render Project control is the generation orchestrator: it renders
clips sequentially, adopts each completed render, extracts the previous clip's
tail, fills the next clip's CONTINUE FROM guide, and waits before advancing.
DumasNodes intentionally remains model-agnostic and handles clean individual
outputs, tail preparation and optional final assembly rather than duplicating
CSGlide's MiniMax generation loop.
Dumas Prepare Continuation
Give this node the raw output of a continuation generation and its reference
frame count. It produces a clean presentation clip and a next_reference
tail clip. Only the tail is intended to feed the next generation; the entire
previous clip is never passed forward as the continuity input.
Other nodes
- Dumas Image Compare
- Save Image Dumas
- Load Images from Folder Dumas
- Dumas JSON helpers
Installation
Copy or clone this repository into ComfyUI/custom_nodes/DumasNodes and restart
ComfyUI. FFmpeg and FFprobe must be available on PATH for the video nodes.
Development
Run the fast unit tests from the repository root:
python -m unittest discover -s tests -p 'test_*.py'