- sync_to_dev.py [BLOCKING]: a top-level symlinked dest (e.g. target/matte -> X) was passed straight into _clean_dest()/copytree(), which follow the link and can mutate files outside the target. Now unlink a symlinked dest and own the path as a real dir (checked before exists(), which follows symlinks). Verified with a repro: the symlink target's file survives. - nodes.py: force float32 on a CPU fallback (CUDA unavailable). Half precision is unreliable on CPU; fp16 kernels would error. Warn that CPU is very slow. - docs: correct the preserved-path guidance to the target-relative "matte/checkpoints" (was a bare "checkpoints" name); reword "near-verbatim reimplementation" -> "independent implementation targeting behavioural parity" to match the NOTICE/pipeline framing. - nodes.py: also warn on a degenerate (<8px) guide-mask region before the full-frame fallback (was silent). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
ComfyUI-Koolook documentation
Three audience buckets — pick where to look based on what you're trying to do.
| If you want to … | Go to | One-line description |
|---|---|---|
| Use a node in your ComfyUI workflow | user_guide/ |
Per-node guides, screenshots, recipes |
| Look something up — a term, a node ID, a list | reference/ |
Glossary, node inventory, spec sheets |
| Cut a release / fork a node / debug CI / hit the Comfy Registry API | maintainers/ |
Releasing, Registry API, Node versioning rules |
| Compare UI design proposals before implementation | designs/ |
Focused mockups and screenshots for in-progress UX decisions |
| Inspect bundled demo workflows | workflows/ |
Source copies of release-ready workflows seeded into the Kforge Labs sidebar |
| Run AI-assisted model evaluation loops | automations/ |
Visual loop overview, setup contract, per-model findings, and /make-card workflow |
Files that intentionally stay at the repo root
| File | Why it's not in docs/ |
|---|---|
../README.md |
GitHub repo home + Comfy Registry pulls description from here |
../LICENSE |
pyproject.toml references it; GitHub recognizes the license badge from this path only |
../CHANGELOG.md |
Changelog parsers and release tooling expect it at root |
../CLAUDE.md |
Claude Code reads project-level agent instructions from <repo>/CLAUDE.md |