| # User Guide |
|
|
| End-user documentation for nodes shipped by `ComfyUI-Koolook`. Pages |
| mirror the ComfyUI category each node lives under, so the structure here |
| matches what you see when you type "koolook" in the node-add menu. |
|
|
| Each per-node page includes a **Source** block at the top that records |
| whether the node is Koolook-native or imported from a fork — so fork |
| attribution is visible without needing a fork-shaped directory tree. |
|
|
| ## Browse by category |
|
|
| | ComfyUI menu | Status | Nodes | |
| |---|---|---| |
| | `Koolook/Pipeline` | ✅ [`EasyAIPipeline`](nodes/koolook_pipeline/easy_ai_pipeline.md) | `EasyAIPipeline` | |
| | `Koolook/Image` | ✅ [`EasyResize_Koolook`](nodes/koolook_image/easy_resize_koolook.md) · ✅ [`easy_ImageBatch`](nodes/koolook_image/easy_image_batch.md) | `EasyResize_Koolook`, `easy_ImageBatch` | |
| | `Koolook/Wan_Video` | ✅ [`EasyWan22Prompt`](nodes/koolook_wan_video/easy_wan22_prompt.md) | `EasyWan22Prompt` | |
| | `Koolook/VAE` | ✅ [`nodes/radiance_koolook_v2_3_3/`](nodes/radiance_koolook_v2_3_3/) | `Easy_hdr_VAE_encode`, `Easy_hdr_VAE_decode` | |
| | `Koolook/Video` | ✅ [`Easy_LoadVideo`](nodes/koolook_video/easy_load_video.md) · ✅ [`Easy_VideoCombine`](nodes/koolook_video/easy_video_combine.md) | `Easy_LoadVideo`, `Easy_VideoCombine` | |
| | `Koolook/Utility` | ✅ [`Easy_Utility`](nodes/koolook_utility/easy_utility.md) | `Easy_Utility` | |
| | `Koolook/Loop` | ✅ [`Koolook_LoopStatus`](nodes/koolook_loop/koolook_loop_status.md) | `Koolook_LoopStatus` | |
| | `Koolook/Publish` | ✅ [`Publish contract nodes`](nodes/koolook_publish/publish_contract_nodes.md) | `Koolook_PublishInput`, `Koolook_PublishOutput`, `Koolook_PublishRouter`, `Koolook_PublishResult` | |
| | `Koolook/Camera` | ✅ [`KoolookLoadCameraPosesAbsolute`](nodes/koolook_camera/koolook_load_camera_poses_absolute.md) | `KoolookLoadCameraPosesAbsolute` | |
| | `Koolook/Testing` | ✅ [`Easy_Pattern`](nodes/koolook_testing/easy_pattern.md) | `Easy_Pattern` | |
| | `Koolook/PromptRelay` | ✅ [`LTXDirector__koolook`](nodes/whatdreamscost_koolook/ltx_director_koolook.md) | `LTXDirector__koolook` | |
|
|
| ## Cross-cutting concepts |
|
|
| Pages here cover ideas that span more than one node: |
|
|
| - [Kforge Labs sidebar guide](../../web/guide/index.html) — visual onboarding for |
| Snapshots, favorite nodes, saved workflows, reusable modules, tags, and recovery. |
| - [VAE encode/decode pairing](nodes/radiance_koolook_v2_3_3/encode_decode_pairing.md) — which |
| encoder fields must match the decoder for a clean roundtrip, with |
| worked examples for SDR / HDR / cinema-log / video workflows. |
| - [HDR modes deep dive](nodes/radiance_koolook_v2_3_3/hdr_modes.md) — what `Clip (SDR)`, |
| `Soft Clip`, `Compress (Log)`, and `Passthrough` actually do to your |
| pixels before they hit the VAE, with per-pixel worked examples. |
|
|
| ## When to add a guide |
|
|
| A node deserves a page if it has any of: |
|
|
| - Non-obvious input semantics (e.g. aspect-ratio strings, frame indexing |
| conventions). |
| - A workflow recipe more useful than the per-input tooltips. |
| - A known limitation or compatibility caveat. |
| - An encode/decode or input/output pairing relationship with other nodes. |
|
|
| Convention: |
|
|
| - One markdown file per canonical node ID, named after the ID |
| (`easy_hdr_vae_encode.md`, `easy_image_batch.md`). |
| - Place it in the folder that matches the node's ComfyUI category. |
| - Screenshots and helper images go in [`img/`](img/), named to match the |
| page they're embedded in (e.g. `easy_hdr_vae_encode_pairing.png`). |
|
|
| ## Where to find the canonical node ID list |
|
|
| The repo [`README.md`](../../README.md) lists the canonical public node IDs |
| and display names. Some compatibility aliases remain registered so older saved |
| workflows load, but new workflows should pick the canonical IDs documented |
| here. The historical inventory (including removed nodes) is in the |
| [`CHANGELOG.md`](../../CHANGELOG.md). |
|
|
