Files

T

malkuthroandClaude Opus 4.7 4739dd4203 feat: Easy_Utility, Easy_LoadVideo, and preview fixes (#184 )

* feat(nodes): add Easy_Utility — INT → padded STRING dispatcher

First mode `int_to_padded_string`: takes an INT widget (with up/down
arrows) and emits a zero-padded STRING (default `001`, no `v` prefix).
The downstream `koolook_versioning.resolve_version_token` prepends `v`
and re-pads, so wiring this into `EasyAIPipeline.version` /
`Easy_VideoCombine.version` yields the standard `vNNN` token at execution.

Designed for extension: the `mode` widget shipped from day one so adding
further conversions (string→int, formatting variants, etc.) doesn't
rewire saved workflows.

Note: the previously-attempted JS preview-resolver refactor that aimed
to fix the "preview shows stale version" bug was reverted in this
worktree before commit — it didn't actually fix the bug (the real cause
is the JS resolver not descending into ComfyUI subgraphs) and it broke
shot_name resolution in the process. The preview-resolver work is NOT
in this commit; only the Python node + tests.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(nodes): guard version widget against pysssss .replace crash

PR #180 added a STRING `version` widget to EasyAIPipeline and
Easy_VideoCombine. Three workflow states leave widget.value undefined
or non-string when graphToPrompt iterates widgets:

- Pre-#180 workflows replay an INT (e.g. `1`) into the new STRING slot.
- Widget-to-input conversion voids the value in newer LiteGraph.
- Easy_VideoCombine's dict-based widgets_values omits the new key
  entirely on workflows saved before #180.

With pysssss/ComfyUI-Custom-Scripts installed, presetText.js patches
every STRING TextWidget.serializeValue to run callbacks that do
`value.replace(...)` for `{variable}` substitution. Any of the states
above crashes graphToPrompt and turns Run into a no-op for the whole
workflow ("Cannot read properties of undefined (reading 'replace')").

Fix: trap `widget.value` reads/writes on the version widget via
`Object.defineProperty` so the property is always coerced to a string
regardless of caller. `configurable: true` so downstream code can
still override the descriptor if it needs to.

Tests: 231 passing; both JS files parse OK.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(ai-pipeline): resolve subgraph version preview

* feat(video): add path-aware load video node

* fix(ai-pipeline): preview connected text names

* fix(pr184): address review cleanup

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-29 15:59:27 +02:00

5.7 KiB

Raw Blame History

ComfyUI-Koolook

Kforge Labs for ComfyUI: a project-kit sidebar plus Koolook nodes for VFX, image, and video workflows.

Start here: KForge Labs ComfyUI-Koolook overview

That overview explains the sidebar, snapshots, saved workflows, modules, recovery tools, and included nodes for new users.

The main experience is the Kforge Labs sidebar. It helps you keep a project setup together: favorite nodes, saved workflows, reusable modules, tags, snapshots, and recovery tools.

Kforge Labs Sidebar

Use the sidebar as a reusable project kit.

Feature	What it does
Snapshots	Save and load the whole Kforge Labs state: favorite nodes, workflows, modules, tags, archive, and recovery data.
Search	Find nodes, workflows, directories, and tags from one field. Tags keep exact capitalization, so `Depth` and `depth` can be separate folders.
Nodes	Keep favorite nodes close, grouped by theme or repository name.
Workflows	Save the whole script, save a selection of nodes, load workflows, or insert saved modules into the current canvas.
Recovery	Use autosaves, starter presets, snapshot library settings, and missing-pack install helpers.

New here? Start with the KForge overview. Using it inside ComfyUI? Open the operational guide:

Browse on the web: malkuthro.github.io/ComfyUI-Koolook/web/guide/
Inside ComfyUI: Kforge Labs sidebar → Tools row → Help (H icon). The in-app button opens the bundled offline copy at web/guide/index.html.

Included Nodes

Node ID	Display name	Category
`EasyWan22Prompt`	Wan 2.2 Easy Prompt (Koolook)	`Koolook/Wan_Video`
`EasyResize_Koolook`	Easy Resize (Koolook)	`Koolook/Image`
`EasyAIPipeline`	Easy AI Pipeline (Koolook)	`Koolook/Pipeline`
`easy_ImageBatch`	Easy Image Batch (Koolook)	`Koolook/Image`
`KoolookLoadCameraPosesAbsolute`	Koolook Load Camera Poses (Absolute Path)	`Koolook/Camera`
`Easy_hdr_VAE_encode`	Easy HDR VAE Encode (Koolook)	`Koolook/VAE`
`Easy_hdr_VAE_decode`	Easy HDR VAE Decode (Koolook)	`Koolook/VAE`
`Easy_Pattern`	Easy Pattern (Koolook)	`Koolook/Testing`
`Easy_LoadVideo`	Easy Load Video (Koolook)	`Koolook/Video`
`Easy_VideoCombine`	Easy Video Combine (Koolook)	`Koolook/Video`

The root Koolook nodes and the slim Radiance Koolook VAE wrappers have no extra Python dependencies beyond torch, which ComfyUI already requires.

Install

ComfyUI-Manager

Open ComfyUI Manager.
Choose Install Custom Nodes.
Install by Git URL: https://github.com/malkuthro/ComfyUI-Koolook.git
Restart ComfyUI.
Open the Kforge Labs sidebar tab.

Manual

Clone this repository into ComfyUI/custom_nodes/:

git clone https://github.com/malkuthro/ComfyUI-Koolook.git

Restart ComfyUI after installation.

Learn More

Public overview: kforgelabs.com/comfyui-projects/comfyui-koolook/
In-app visual guide: malkuthro.github.io/ComfyUI-Koolook/web/guide/ (offline copy: web/guide/index.html)
Support / bug reports: SUPPORT.md
User guide: docs/user_guide/
Change history: CHANGELOG.md
Maintainer docs: docs/maintainers/
Fork attribution and provenance: forks/THIRD_PARTY.md
Versioning reference: docs/reference/versioning.md

Troubleshooting

What you see	What it usually means	What to do
The Kforge Labs tab does not appear	ComfyUI needs a restart, or the extension did not load	Restart ComfyUI and check the terminal for `[Koolook]` messages.
The Help guide does not open	The browser blocked the popup	Allow popups for the ComfyUI page, or open `web/guide/index.html` directly.
Missing custom nodes after loading a workflow	One or more node packs used by that workflow are not installed	In Kforge Labs, use Tools → Install missing packs, or use ComfyUI Manager's Install Missing Custom Nodes flow.
Snapshot save/load fails	The snapshot library path may be missing, read-only, or unavailable	Use Snapshot → Save to... or Load from... and choose a writable folder.
A loaded snapshot looks older than expected	Named saves and auto-saves are intentionally separate	In Snapshot → Load, select the snapshot and check Recovery auto-saves for a newer periodic/pre-load recovery.

Support

For reproducible bugs, open a GitHub issue. For the fastest answer, include your ComfyUI version, Koolook version, operating system, install method, terminal log, browser console errors, and steps to reproduce. See SUPPORT.md for the exact checklist.

Stability

For production work, install a pinned release tag or commit instead of following a moving branch head. Node IDs are treated carefully so saved ComfyUI workflows continue to load across compatible updates.

License

GPL-3.0. See LICENSE.

This package incorporates and adapts GPL-3.0 code from fxtdstudios/radiance under forks/radiance_koolook/. Attribution and per-fork modification notes are tracked in forks/THIRD_PARTY.md and forks/forks_manifest.yaml.

5.7 KiB Raw Blame History