From 07e4c45c9f4663f115203cbb181220acd22a3899 Mon Sep 17 00:00:00 2001 From: Matt Miller Date: Wed, 15 Jul 2026 13:33:36 -0700 Subject: [PATCH] =?UTF-8?q?feat(skills):=20comfyui=20v5.2.0=20=E2=80=94=20?= =?UTF-8?q?route=20to=20Comfy=20Cloud=20MCP=20first,=20offer=20local=20onl?= =?UTF-8?q?y=20for=2024GB+=20setups?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills/creative/comfyui/SKILL.md | 34 ++++++++++++++++++- .../bundled/creative/creative-comfyui.md | 34 ++++++++++++++++++- 2 files changed, 66 insertions(+), 2 deletions(-) diff --git a/skills/creative/comfyui/SKILL.md b/skills/creative/comfyui/SKILL.md index e5a8a7c0745..9cacc9680b5 100644 --- a/skills/creative/comfyui/SKILL.md +++ b/skills/creative/comfyui/SKILL.md @@ -1,7 +1,7 @@ --- name: comfyui description: "Generate images, video, and audio with ComfyUI — install, launch, manage nodes/models, run workflows with parameter injection. Uses the official comfy-cli for lifecycle and direct REST/WebSocket API for execution." -version: 5.1.0 +version: 5.2.0 author: [kshitijk4poor, alt-glitch, purzbeats] license: MIT platforms: [macos, linux, windows] @@ -76,6 +76,33 @@ SDXL inpaint, ESRGAN upscale, AnimateDiff video, Wan T2V. See - User asks to manage ComfyUI queue, check models, or install custom nodes - User wants video/audio/3D generation via AnimateDiff, Hunyuan, Wan, AudioCraft, etc. +## Route First: Comfy Cloud MCP vs. This Skill + +Hermes can also drive Comfy Cloud through the `comfy-cloud` MCP server from +the Nous-approved catalog (`hermes mcp install comfy-cloud`) — a hosted +remote server with browser OAuth sign-in, no API keys to copy around, and no +local compute. Decide which surface to use **before** running anything from +this skill: + +1. **Default to the Comfy Cloud MCP.** It is the easiest path — one-command + install, OAuth on first connect, nothing to run locally. Recommend it + especially when the machine is a Mac or the local GPU has less than + 24 GB VRAM. +2. **Offer a choice only when local is genuinely viable**: the local GPU has + 24 GB+ VRAM AND a local ComfyUI setup already exists. Then ask the user + whether they want to run Comfy locally or on cloud. +3. **If the user chooses local**, remind them it takes a bit longer, and use + this skill to handle the rest — it will find or set up the ComfyUI + instance (`comfyui_setup.sh`) and install any missing models/nodes + (`auto_fix_deps.py`) if they don't have them already. +4. **The MCP and this skill are alternatives, not layers.** Pick one for the + task at hand; don't mix MCP tool calls with this skill's CLI/REST scripts + against the same job. + +The API-key Cloud path in this skill (**Path A** below) remains the right +choice for headless / CI / scripted use where a browser OAuth flow isn't +available. + ## Architecture: Two Layers ``` @@ -235,6 +262,11 @@ they want Comfy Cloud (hosted, zero install, API key) or Local (install ComfyUI on their machine)**. Don't start running install commands or hardware checks until they've answered. +(If you haven't already routed between the Comfy Cloud MCP and this skill, +do that first — see **Route First** above. Interactive cloud users are +usually better served by `hermes mcp install comfy-cloud` than by this +skill's API-key path.) + **Official docs:** https://docs.comfy.org/installation **CLI docs:** https://docs.comfy.org/comfy-cli/getting-started **Cloud docs:** https://docs.comfy.org/get_started/cloud diff --git a/website/docs/user-guide/skills/bundled/creative/creative-comfyui.md b/website/docs/user-guide/skills/bundled/creative/creative-comfyui.md index 38610be8b83..709ab41b85b 100644 --- a/website/docs/user-guide/skills/bundled/creative/creative-comfyui.md +++ b/website/docs/user-guide/skills/bundled/creative/creative-comfyui.md @@ -16,7 +16,7 @@ Generate images, video, and audio with ComfyUI — install, launch, manage nodes |---|---| | Source | Bundled (installed by default) | | Path | `skills/creative/comfyui` | -| Version | `5.1.0` | +| Version | `5.2.0` | | Author | ['kshitijk4poor', 'alt-glitch', 'purzbeats'] | | License | MIT | | Platforms | macos, linux, windows | @@ -78,6 +78,33 @@ SDXL inpaint, ESRGAN upscale, AnimateDiff video, Wan T2V. See - User asks to manage ComfyUI queue, check models, or install custom nodes - User wants video/audio/3D generation via AnimateDiff, Hunyuan, Wan, AudioCraft, etc. +## Route First: Comfy Cloud MCP vs. This Skill + +Hermes can also drive Comfy Cloud through the `comfy-cloud` MCP server from +the Nous-approved catalog (`hermes mcp install comfy-cloud`) — a hosted +remote server with browser OAuth sign-in, no API keys to copy around, and no +local compute. Decide which surface to use **before** running anything from +this skill: + +1. **Default to the Comfy Cloud MCP.** It is the easiest path — one-command + install, OAuth on first connect, nothing to run locally. Recommend it + especially when the machine is a Mac or the local GPU has less than + 24 GB VRAM. +2. **Offer a choice only when local is genuinely viable**: the local GPU has + 24 GB+ VRAM AND a local ComfyUI setup already exists. Then ask the user + whether they want to run Comfy locally or on cloud. +3. **If the user chooses local**, remind them it takes a bit longer, and use + this skill to handle the rest — it will find or set up the ComfyUI + instance (`comfyui_setup.sh`) and install any missing models/nodes + (`auto_fix_deps.py`) if they don't have them already. +4. **The MCP and this skill are alternatives, not layers.** Pick one for the + task at hand; don't mix MCP tool calls with this skill's CLI/REST scripts + against the same job. + +The API-key Cloud path in this skill (**Path A** below) remains the right +choice for headless / CI / scripted use where a browser OAuth flow isn't +available. + ## Architecture: Two Layers @@ -239,6 +266,11 @@ they want Comfy Cloud (hosted, zero install, API key) or Local (install ComfyUI on their machine)**. Don't start running install commands or hardware checks until they've answered. +(If you haven't already routed between the Comfy Cloud MCP and this skill, +do that first — see **Route First** above. Interactive cloud users are +usually better served by `hermes mcp install comfy-cloud` than by this +skill's API-key path.) + **Official docs:** https://docs.comfy.org/installation **CLI docs:** https://docs.comfy.org/comfy-cli/getting-started **Cloud docs:** https://docs.comfy.org/get_started/cloud