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 about a month ago·Updated 8 days ago· 0
Nocturne-Ai-Labs/Umbra-Nodes
Nodes—
On cloudLocal install
Stars0
Updated8 days ago
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

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.