Nodes/H3 Relay/H3RelayInternalRestoreRawSequence
ComfyUI Node

H3RelayInternalRestoreRawSequence

Pick up a raw H3 sequence where you left it — shots, not video files

By akatz-ai·Created 28 days ago·Updated 8 days ago· 15
H3RelayInternalRestoreRawSequence
    • sequence
    run_name
    shot_index1

    H3RelayInternalRestoreRawSequence is the raw-side twin of H3RelayInternalRestoreEnhanced. Where that node re-opens your LTX/interpolation finishing state, this one re-opens the native MiniMax H3 continuation state - the sequence wire - up to a given shot, straight from the disk cache. Same idea, other half of the pipeline.

    The reason this matters: raw H3 continuation depends only on accepted raw H3 checkpoints. Not on the LTX stack, not on the interpolation model, not on anything that comes after. So restoring a raw sequence and resuming from shot 3 is a pure H3 operation - cheap to validate, no big models touched. That's the design that lets you review each native 480p shot with its audio, reroll the ones you don't like, and only then decide to pay for the finishing pass.

    How it works

    The node takes just two inputs, both normally supplied by the pack's own graph expansion:

    • run_name - the run you want to reopen.
    • shot_index - how many accepted shots to carry forward (default 1, max 128).

    It reads the run's integrity-checked disk manifest, truncates the sequence to shot_index, and returns it as a single sequence (H3_RELAY_SEQUENCE) output. Truncation is the subtle part: H3 Relay keeps sliding history per shot, so the restored sequence carries exactly the accepted continuation history up to that point, and the next Generate Shot continues from there rather than replaying shots you already approved.

    Because every accepted shot was verified with SHA-256 when it was written, restore trusts nothing on faith. If a checkpoint is missing or corrupted, you get a hard error telling you which shot failed - not a silent continuation from garbage.

    When you'd use it

    The Assemble node's staged, bounded-RAM execution path uses this internally to reconstruct each partial prompt's required raw state without re-running loaders. But you can also wire it yourself: the classic manual workflow is "generate shots 1–4, review, then branch." Point this node at the run with shot_index: 3, feed the restored sequence into a fresh Generate Shot, and you're exploring an alternate take on shot 4 without paying for shots 1–3 again.

    That's the resumable promise of the pack made concrete: a long-form movie doesn't have to be one monolithic queue. It's a bunch of small, reviewable, independently re-runnable steps, and this node is how you re-enter the middle of one.

    Install and gotchas

    Same shared install as the whole pack: ComfyUI Manager → search H3 Relay → install → restart (or git clone https://github.com/akatz-ai/h3-relay into custom_nodes). ComfyUI 0.32.0+, FFmpeg on PATH, model files per MODELS.md, separately licensed.

    The failure you'll actually see is restore is missing completed delivery shots - which means run_name or shot_index doesn't match anything accepted on disk. Check the run name, and remember the run lives under user/__h3_relay_cache, not output/. If you cleared the cache, the run is gone and nothing will restore it.

    CategoryH3 Relay/internal

    Inputs (2)

    NameTypeDefaultDescription
    run_nameSTRING
    shot_indexINT11–128

    Outputs (1)

    NameTypeDescription
    sequenceH3_RELAY_SEQUENCE