MiniMax H3 Run Manager
Reopen a finished MiniMax H3 production and its reference media, months later, from disk
- plan
- asset_0
- asset_1
- asset_2
- asset_3
- asset_4
- asset_5
- asset_6
- asset_7
- asset_8
- asset_9
- asset_10
- asset_11
- source_timeline
- tagged_references
- plan
- source_timeline
Run Manager is the "where did that production go?" node. Every Contex Loop run lives in a folder under ComfyUI/output/h3_chains/<run_name>/ - checkpoints, segment MP4s, audio sidecars, recovery metadata - but a run folder on disk is not the same thing as a run you can open. This node browses those projects, restores a saved run's Plan and its loader-backed reference assets, and lets you promote one archived source track into the Plan's recoverable Source Timeline. In other words: it turns a pile of checkpoint files back into an editable, resumable production.
If you've ever had to rebuild a workflow from metadata after the originals rotted on disk, you know exactly why this exists. Video reference files get moved, renamed, or lost between sessions; a production you set aside in March shouldn't be unrecoverable in April.
What it does
Connect your active plan - the Run Manager can replace that Plan's prompts and settings with a saved run's, after confirmation, and it passes the current Plan through at execution time. The node also registers loader outputs: connect a loader output to one of the asset_0 through asset_11 sockets and it records the source file for the run, reading the graph link without decoding or retaining the media. Three toggles control what gets archived as content-addressed fallback copies in the run folder:
- archive_images (default on) - fallback copies of connected picture assets.
- archive_audio (default on) - fallback copies of audio references and source tracks.
- archive_video (default off) - fallback video copies, off by default because video assets can balloon a run archive. Turn it on only if you genuinely can't count on the originals.
The tagged_references input takes the final Tagged reference line (from the last Tagged Picture/Video/Audio Ref, or from Semantic Anchor Bundle) so the manager can discover and archive any semantic image loaders the bundle carries.
The Source Timeline promotion is the clever recovery feature: if exactly one loader asset is assigned the Source track role, it automatically becomes the recoverable Source Timeline - unless you pass an explicit source_timeline wire, which takes priority. Outputs: plan (the connected Plan plus JSON-safe Source Timeline recovery metadata) and source_timeline (a path-backed timeline for Loop Start, Tagged Motion, preview, and final assembly). A restored run is not just viewable - it's executable again, because the references come back with it.
Install
From ComfyUI-MiniMaxH3-Contex-Loop. ComfyUI Manager → search the pack, or:
cd ComfyUI/custom_nodes
git clone https://github.com/ethanfel/ComfyUI-MiniMaxH3-Contex-Loop.git
Restart. No pip dependencies. Needs a current ComfyUI with native Add Guide for MiniMax H3 for the generation side; the H3 weights aren't bundled and are license-locked out of the US/EU/UK/South Korea.
Gotchas
The archive toggles are the trap. archive_video being off is a deliberate default, but if your references are video and you can't guarantee the originals stay put, a future restore will find archived pictures and audio but not video - and the failure will happen at the most inconvenient time. Also, restore is confirmation-gated and replaces the current Plan's prompts and settings, so treat it as the destructive-ish action it is. The manager reading "the graph link without decoding or retaining the media" also means it trusts your wiring: a reference you never connected to an asset socket isn't in the archive, no matter how sure you were that it was.
Inputs (19)
| Name | Type | Default | Description |
|---|---|---|---|
| plan | H3_CHAIN_PLAN | Connect the active H3 Chain Plan. The Run Manager can replace that Plan's prompts and settings with a saved run after confirmation; execution passes the current Plan through. | |
| archive_images | BOOLEAN | true | Keep content-addressed fallback copies of connected picture assets in the run folder. |
| archive_audio | BOOLEAN | true | Keep fallback copies of connected audio references and source tracks. |
| archive_video | BOOLEAN | false | Keep fallback copies of connected video assets. Disabled by default because videos can make a run archive very large. |
| asset_bindings_json | STRING | [] | Internal loader-binding manifest maintained by the Run Manager interface. |
| asset_0opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_1opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_2opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_3opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_4opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_5opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_6opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_7opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_8opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_9opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_10opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| asset_11opt | * | Connect a loader output to register its source file for this run. The manager reads the graph link without decoding or retaining the media. | |
| source_timelineopt | H3_SOURCE_TIMELINE | Optional explicit media wire. It takes priority over automatic promotion; otherwise exactly one loader asset assigned the Source track role becomes the recoverable Source Timeline automatically. | |
| tagged_referencesopt | H3_TAGGED_REFERENCES | Final Tagged reference line. Connect it directly from the last Tagged Picture, Video, or Audio Ref, or from Semantic Anchor Bundle when semantic pictures are used. The manager also discovers and archives any semantic image loaders carried by that optional bundle. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| plan | H3_CHAIN_PLAN | The connected Plan with JSON-safe Source Timeline recovery metadata from either the explicit media wire or the promoted Source track asset. |
| source_timeline | H3_SOURCE_TIMELINE | Path-backed Source Timeline for Loop Start, Tagged Motion, preview, and final assembly. |