CodeComfy Handbook
Welcome to the CodeComfy Handbook — your reference for driving ComfyUI from inside VS Code.
CodeComfy bridges your editor and your ComfyUI server so you never have to switch windows. Open the Command Palette, pick a profile, answer the inputs that preset actually needs, and find the finished output in your workspace.
The six profiles
Section titled “The six profiles”CodeComfy covers six capability profiles. CodeComfy: Run… (all profiles) is
the single entry point to all of them.
| Profile | What it does |
|---|---|
| Image | Text-to-image, image edit, union ControlNet |
| Video | Text- and image-to-video on real temporal models |
| Audio | Text-to-music and stem separation |
| 3D | Image-to-mesh, exported as GLB |
| Inference | Caption, tag, detect, segment, and OCR an image |
| Metadata | Read the workflow embedded in a PNG — local-only |
See Profiles for the full preset list and what each one asks you for.
Two things worth knowing up front
Section titled “Two things worth knowing up front”Nothing is submitted before it can succeed. Every preset is checked against
your server first — its node types against /object_info, its model files
against /models. A missing node names the pack that provides it; a missing
model names the file and the folder it belongs in. No GPU time is spent finding
out.
The workflows are not hand-written here. They are vendored from comfy-headless, where every node type is verified against the live ComfyUI catalog. A wrong workflow graph does not throw an error — it runs green and returns nothing — so a second hand-maintained copy would be a silent-failure generator.
What you will find here
Section titled “What you will find here”- Getting Started — prerequisites, installation, configuration, and your first generation.
- Profiles — all six profiles, their presets, and what each needs from you.
- Usage Guide — daily workflow patterns, prompt tips, output management, and run pruning.
- Presets — authoring your own workflow presets.
- Run History — browsing and re-running past generations.
- Configuration — every setting, explained.
- Reference — generation limits, architecture overview, troubleshooting, platform notes, and security scope.
- For Beginners — new to AI generation or VS Code extensions? Start here.
Quick links
Section titled “Quick links”| Resource | Link |
|---|---|
| GitHub repository | mcp-tool-shop-org/codecomfy-vscode |
| Releases (VSIX downloads) | Releases page |
| Issue tracker | Open an issue |
| ComfyUI project | github.com/comfyanonymous/ComfyUI |
| Verified workflow KB | comfy-headless |
| FFmpeg downloads | ffmpeg.org/download.html |