92 lines
3.4 KiB
Markdown
92 lines
3.4 KiB
Markdown
# DumasNodes
|
|
|
|
Generic ComfyUI utility nodes under the Dumas brand. The repository contains
|
|
image, JSON and video utilities and intentionally has no model-specific video
|
|
sampler dependency.
|
|
|
|
## 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.
|
|
|
|
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'
|
|
```
|