malkuthroandClaude Opus 4.7
70dab39781
Headline themes for 0.3.0: - **Snapshot library** — save/load full Kforge Labs state to a configurable on-disk path, per-preset autosave subfolders, Quick Save, status dot, in-UI recovery, atomic writes, YES/NO modal on newer auto-save, library folder browser, 24-hour timestamps with relative-recent tier. - **Modules** — tag a saved workflow `module` (or use the new "Save as module" checkbox on selection saves) and left-click splices the cluster into the live canvas instead of replacing it. Subgraph wrapper nodes carry their `definitions.subgraphs` entries on save. Insert pre-flight toast surfaces both pack-miss and subgraph-miss cases in plain English. - **Install missing for picks** — one-click installation of missing nodes via ComfyUI-Manager, with discovery → confirm → progress → result UX. - **Hover preview + group modes** — node mock card on row hover, segmented Repository / Theme grouping toggle in the Nodes section, flatten-on-search, spotlight-on-add, × removability for any visible favorite, theme-classifier rework. - **GitHub Pages guide** — bundled visual onboarding now also live at https://malkuthro.github.io/ComfyUI-Koolook/web/guide/, replacing the previous unmaintained wiki link in pyproject.toml's Documentation URL. - **Doc accuracy + polish** — refreshed forks/READMEs (v1_0_1 → v2_3_3), retired stale copilot-instructions, fixed namespace-suffix bullet in THIRD_PARTY.md. Tracked in #120. Full detail in CHANGELOG.md `[0.3.0]`. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ComfyUI-Koolook
Kforge Labs for ComfyUI: a project-kit sidebar plus Koolook nodes for VFX, image, and video workflows.
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 users should start with the visual guide:
- Browse on the web: malkuthro.github.io/ComfyUI-Koolook/web/guide/
- Inside ComfyUI: Kforge Labs sidebar → Tools row → Help (
Hicon). The in-app button opens the bundled offline copy atweb/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 |
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
- Visual sidebar guide: malkuthro.github.io/ComfyUI-Koolook/web/guide/
(offline copy:
web/guide/index.html) - 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
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.