# 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: ```text 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` is a replacement for the upstream Second Pass when tiled latent upscale is required. It applies the native H3 tiled upscale independently to each physical Continuum clip, passes the first-pass audio latents through unchanged, and returns the updated assembly plan plus status. 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: ```bash python -m unittest discover -s tests -p 'test_*.py' ```