ComfyUI Eclipse Nova

ComfyUI Eclipse Nova

Eclipse Nova provides prompt editors, image/video/audio tools, sampling settings, character workflows and routing utilities for ComfyUI. Its redesigned nodes use compact panels with collapsible sections, searchable choices and resizable previews in classic canvas and Nodes 2.0.

1.0.0 is Nova’s initial release. Nodes use [Eclipse Nova] IDs and the 🌒 Eclipse Nova menu, separate from the original Eclipse pack. Original Eclipse workflows need their nodes replaced explicitly; Nova does not include legacy aliases or workflow migration tools.

Explore the nodes

Start with the visual tour for annotated screenshots, or use the documentation index to find a specific node. The screenshots show the Amber theme; Neutral is the default.

| Work with… | Guides | | --- | --- | | Prompts and text | Smart Prompt, Wildcard Processor, String Multiline, Prompt Styler, Prompt Forge | | Sampling and dimensions | Sampler panels, Smart Folder, Resolution Pipe | | Images | Loaders, Resize, Adjustments, Text/Image FX, Selection and comparison | | Saving and metadata | Save Images, Save Video, Read Prompt Files, Save Prompt | | Audio and video | Load Audio, Recorder, Load/Preview Video, Scene and motion analysis, Upscale Video, Lyric Captions | | Character and timeline workflows | Character references, Shot Planner, MiniMax audio planning, MiniMax native clips, Frame timelines | | Routing and review | Set/Get and Bridge, Get First / Get All Active, Previews and Stop, Prompt Review, Utilities |

Reference-video analysis measures scene boundaries on CPU, limits cut frequency when requested, and samples bounded windows from disk or RAM. SmartLLM Nova describes motion for a separate image reference or full scenes for text-to-video. The H3 adapter supplies measured cut times and separate global, first-part and next-part prompts. See the scene analysis guide for node connections, independent detection/image resolutions, review warnings and saved-analysis reuse.

Video Run Storage switches loop accumulation between CPU RAM, temporary disk and persistent output. Load Video Run restores saved parts and their soundtrack after a restart, while Video Run Info reports timing, size and part ranges. Video Loop Start / Loop End render and resume H3 runs without Easy-Use. Persistent runs save resolved timings, prompts, references and audio, so resume can reuse them after a restart. Stop after the current part and its accumulated preview, or limit the new parts per queue. Video Part Seed keeps sampling variation separate from planning and the retained media. Loop Control puts the live stop button outside a subgraph, connected to the loop through Get/Set. Part Prompt Editor reads prompts from the existing saved run selection and replaces the text for individual render parts on Resume. Edits persist in the new revision while retained media stays intact. See loop controls for wiring, prompt editing and resume. See saved runs for connections and the execution gates used to skip generation during re-export.

The bundled Get All Active shared-chain preview demonstrates routing with solid-color images and requires no models or input files.

Why the new panels?

Canvas performance was a major reason for the redesign. A panel stores its configuration together and renders the controls it needs locally. Nova no longer uses the old widget-visibility manager, global resize/performance helpers or recurring canvas scans for these panels. Changes are driven by editing, loading and execution events. Routing, pipes and dynamic-input utilities retain their specialized controls.

The design and panel approach are inspired by the DaSiWa node set. Mode bars select features; section headers show concise summaries; pins keep selected sections open. Folding a section changes the layout, not the stored settings. Text and preview panels fit within the node size chosen by the user.

Choose Settings → Eclipse Nova → Appearance → Node design for Jade, Neutral, Ocean, Amethyst or Amber, plus Neutral Jade, Neutral Ocean, Neutral Amethyst and Neutral Amber for lighter backgrounds and titles with colored controls. Use Theme editor → Edit themes in the same settings section to adjust colors, opacity and shadows with a preview, then Save or Save As. You can also edit JSON themes under themes/custom/ and reload them from settings. Bundled themes are extracted once from .defaults/themes/; edits and deletions in themes/ survive updates. The selected design styles panel controls and untouched node defaults, preserving custom title and background colors across workflow reloads. Theme regular nodes and Theme groups are separate Appearance options, both off by default. Turning either off restores the previous colors. Preferences are stored in this pack’s config.json. The optional Link Nova themes button keeps installed SmartLLM Nova and Smart Model Loader Nova packs on Eclipse's theme, so future selections apply to all three. See Node designs for details and colors.

Enable Settings → Eclipse Nova → General → Use Sliders to add sliders to bounded numeric fields in the redesigned panels. The setting applies immediately to existing and new nodes in both renderers. You can still type exact numbers; seed fields retain their exact integer text controls.

Install

From your ComfyUI directory:

git clone https://github.com/r-vage/ComfyUI_Eclipse_Nova.git custom_nodes/ComfyUI_Eclipse_Nova
python -m pip install -r custom_nodes/ComfyUI_Eclipse_Nova/requirements.txt

Use the same Python environment that runs ComfyUI. For Windows portable, run this from the portable installation’s root instead:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI_Eclipse_Nova\requirements.txt

Restart ComfyUI and reload the browser. Search for [Eclipse Nova] or open the 🌒 Eclipse Nova menu. Character and MiniMax tools have their own submenus.

Some features need additional runtimes: the Advanced Detailer has optional YOLO, SAM2 and matting backends; video, audio and caption tools also have their own requirements. The diffusion detailer engine is included in Eclipse. Check the relevant guide before using those features. Wildcard Processor uses Nova’s own engine and does not require Impact Pack.

Optional companion packs

Smart Model Loader Nova provides diffusion-model loading, CLIP/LoRA tools, model presets and the Download Manager. Model source/integrity fields and download-to-loader integration belong to that pack, not Eclipse Nova.

SmartLLM Nova provides language-model and detection tooling. Follow its setup guide. Companion packs own their node IDs, settings, model registries and credentials; Eclipse does not install or configure them.

Pipes and connected overrides

Nova’s PIPE is a dictionary of related values. Smart Sampler Settings contributes only enabled settings; Smart Folder supplies paths and dimensions; Generation Data carries information for metadata and saving. Context and pipe tools combine or extract those values.

A PIPE is not interchangeable with every other pack’s tuple-based BASIC_PIPE or custom context type. Follow the input labels and each node’s guide. The Detailer, for example, takes its model/conditioning from basic_pipe and optional sampling overrides from pipe_opt.

Where a panel has explicit input sockets, its guide explains their priority. For example, Image Resize can use connected width/height values, and the samplers have a Use pipe settings switch. Loading a file or metadata does not implicitly replace every downstream setting: use the relevant Include controls or pipe inputs to choose what travels through the workflow.

Your files and settings

User-editable data lives inside this repository:

| Location | Purpose | | --- | --- | | prompts/ | Smart Prompt folders and Prompt Forge tag lists | | styles/ | Prompt Styler CSV/JSON/TXT libraries | | wildcards/ | Packaged wildcard examples; the engine also reads ComfyUI wildcard folders | | patterns/ | Save Prompt content-rating terms | | themes/ | Editable JSON themes and custom/ overrides; extracted once | | config.json | Private Eclipse Nova configuration | | .defaults/ | Distributed .example sources and their manifest |

Startup extracts new defaults. An updated default replaces its extracted copy only if that copy still matches the previously shipped hash. Edited files and intentionally deleted known files stay untouched. Edit the extracted files in prompts/, styles/ and the other data folders, rather than .defaults/.

The models/wildcards/smart_prompt_nova link exposes Nova’s prompt files to wildcard expansion without duplicating them. Startup preserves a real directory at that location and leaves the original Eclipse smart_prompt link untouched. Nova reads a working original prompt link while that checkout is available; links to removed or disabled checkouts, or an old link pointing back into Nova, are ignored. Use __smart_prompt_nova/...__ for Nova’s prompt library. Back up your custom data and workflows before reinstalling or removing a checkout.

Help and contributing

If nodes are missing, check the ComfyUI startup log and install dependencies into the environment actually running it. After updating Python code, restart ComfyUI; after updating frontend code, reload the browser as well.

For a bug report, include the ComfyUI/frontend versions, renderer (classic or Nodes 2.0), traceback and a small reproducible workflow. Remove private paths, prompts and credentials before sharing it.

Contributions to the nodes and documentation are welcome. Licensed under Apache 2.0.