Extensions/Umbra Nodes
ComfyUI Extension

Umbra Nodes

Umbra Studio custom nodes for ComfyUI metadata saving, Power Prompter integration, and workflow bridge support.

By Nocturne-Ai-Labs·Created 2 months ago·Updated 9 days ago· 0
Nocturne-Ai-Labs/Umbra-Nodes
Nodes21
On cloudLocal install
CategoryUmbra Lab, Umbra/Detailer/Providers
Stars0
Updated9 days ago

Nodes (21)

A1111 LoRA Syntax (Umbra Lab)

Name:0.8> in your prompt again — no loader node required

Umbra Lab
CFG Value (Umbra Lab)

One CFG, five samplers — a single dial for the whole graph

Umbra Lab
Flux.2 Detailer Sampling Provider (Umbra)

Give your Flux.2 detail crops their own scheduler — not a one-size sampler

Umbra/Detailer/Providers
Frame Interpolate (Umbra UI)

Frame Interpolate — smooth slow-mo without blowing up your VRAM

Umbra/UI
HiDream O1 Detailer Sampling Provider (Umbra)

HiDream O1 detail crops need LCM-style sampling — this provider does the legwork

Umbra/Detailer/Providers
Ideogram 4 Detailer Sampling Provider (Umbra)

Ideogram 4's dual-model guider, wired into your detail crops

Umbra/Detailer/Providers
Image Detailer (Umbra UI)

The detailer that fixes person, face, eyes, and hands in order — one node

Umbra/UI
Image Upscale (Umbra UI)

A model upscaler that respects a maximum dimension — and never double-scales

Umbra/UI
KSampler (Umbra Lab)

A KSampler that tells the truth about what it ran

Umbra Lab
KSampler Hires Fix (Umbra UI)

A Forge-style hires fix in one node — with an honest upscale list

Umbra Lab
KSampler Normal (Umbra Lab)

KSampler Normal — the plain sampler that labels itself for clarity

Umbra Lab
Save Image (Umbra Lab)

A save node that writes your PNG, your workflow, and an A1111-readable settings string

Umbra Lab
Save Image Simple (Umbra Lab)

The save node that figures out your prompt so you don't have to type it

Umbra Lab
Load Checkpoint (Umbra Lab)

One loader for checkpoints, diffusers, UNets, and GGUF — no juggling nodes

Umbra Lab
OmniGen2 Detailer Sampling Provider (Umbra)

OmniGen2 detail crops with dual-CFG guidance — regular or nested

Umbra/Detailer/Providers
Power Prompter (Umbra Lab)

Power Prompter — the entire front half of a workflow in one node

Umbra
Power Prompter Websocket

Power Prompter Websocket — the node that listens to Umbra's prompt cards

Umbra
Seed Value (Umbra Lab)

The seed node that understands batches and repeats, so you don't have to

Umbra Lab
Soft Inpaint Composite (Umbra UI)

Soft Inpaint Composite — blend the fix in without ghosting the subject

Umbra UI/Inpaint
Steps Value (Umbra Lab)

Steps, defined once, everywhere — the boring node that prevents silent drift

Umbra Lab
Video Upscale (Umbra UI)

The 'more pixels' pass that won't shimmer or rewrite your frames

Umbra/UI
Readme

Umbra Nodes

Umbra Nodes is the ComfyUI custom-node package used by Umbra Studio.

It provides Umbra metadata save nodes, Power Prompter bridge nodes, prompt/runtime helpers, and Umbra-specific workflow support for ComfyUI.

Included Nodes

  • Power Prompter (Umbra Lab)
  • Power Prompter Websocket
  • Save Image (Umbra Lab)
  • Save Image Simple (Umbra Lab)
  • A1111 LoRA Syntax (Umbra Lab)
  • KSampler (Umbra Lab)
  • KSampler Normal (Umbra Lab)
  • CFG Value (Umbra Lab)
  • Steps Value (Umbra Lab)
  • Seed Value (Umbra Lab)
  • Load Checkpoint (Umbra Lab)
  • Image Detailer (Umbra UI)
  • Image Upscale (Umbra UI)

The Umbra UI detailer presents a stable person, face, eye, and hand refinement contract while keeping detector/SAM wiring inside Umbra Nodes. The upscale node uses a selected super-resolution model and applies a true maximum-dimension cap; it never enlarges an already-smaller model output a second time.

Umbra UI Dependencies

Legacy Anima LoRAs on Anima 2.9B

The Power Prompter and A1111 LoRA Syntax nodes automatically remap original 28-block Anima LoRAs when the connected model is a 40-block Anima model. This uses the layer positions recorded in the official expansion manifest. Existing model/CLIP strengths and prompt syntax remain unchanged. Text-encoder and LLM-adapter keys are not reindexed. No conversion files are written and no global ComfyUI loader patch is installed.

Native 2.9B and already-converted LoRAs pass through. Automatic legacy detection requires coverage of all 28 original blocks. Partial-layer LoRAs whose original architecture cannot be determined are rejected with an actionable error. Other model families and ordinary 28-block Anima retain their existing loading path. Remapping corrects layer correspondence; it does not guarantee identical visual results to the original Anima model, or compatibility with every LoRA variant.

After installing a release containing this change, restart ComfyUI. Umbra Studio installs/updates this package through its existing custom-node installer; a Studio-only update does not replace an older installed Umbra Nodes checkout.

The image detailer requires ComfyUI Impact Pack and Impact Subpack. Its balanced profile currently expects these model files in the normal ComfyUI model folders:

  • models/sams/sam_vit_b_01ec64.pth
  • models/ultralytics/segm/person_yolov8m-seg.pt
  • models/ultralytics/bbox/face_yolov8m.pt
  • models/ultralytics/bbox/Eyes.pt
  • models/ultralytics/bbox/hand_yolov8s.pt

The default image upscale profile uses models/upscale_models/4x-AnimeSharp.pth and caps the final long edge at 3840 pixels.

Manual Install

Clone this repository into your ComfyUI custom nodes folder:

cd ComfyUI/custom_nodes
git clone https://github.com/Nocturne-Ai-Labs/Umbra-Nodes.git Umbra-Nodes

Restart ComfyUI after installing or updating.

ComfyUI-Manager / Registry

This repository includes:

  • pyproject.toml for Comfy Registry metadata
  • .comfyignore for registry package cleanup

Before publishing to Comfy Registry, make sure the PublisherId in pyproject.toml matches the registered Comfy Registry publisher account.

Relationship To Umbra Studio

Umbra Studio installs and updates this package from the public repository into its managed ComfyUI runtime. Umbra Nodes is not bundled into Umbra Studio portable packages, which keeps one canonical source for both Umbra and ComfyUI-Manager installations.

License

MIT. See LICENSE.