Skip to content

docs(comfyui): add system detection + hardware-aware recommendations to onboarding - #26400

Closed
Master-Rensei wants to merge 5 commits into
NousResearch:mainfrom
Master-Rensei:feat/comfyui-skill-v3
Closed

docs(comfyui): add system detection + hardware-aware recommendations to onboarding#26400
Master-Rensei wants to merge 5 commits into
NousResearch:mainfrom
Master-Rensei:feat/comfyui-skill-v3

Conversation

@Master-Rensei

Copy link
Copy Markdown

Summary

Single commit adding automated system-detection steps to the ComfyUI skill onboarding. Instead of asking users what hardware they have, the agent now:

  1. Runs system detection commands (OS, GPU, VRAM, RAM, disk, Python)
  2. Checks if ComfyUI is already installed/running
  3. Recommends the best install path based on findings

Changes

optional-skills/creative/comfyui/SKILL.md — 69 insertions, 2 deletions

Context

This is the remaining commit from the original feat/comfyui-skill-v3 branch after the first 4 commits were cherry-picked onto main via #17610. Note that the path (optional-skills/) differs from the current main (skills/ via #17631) — this branch would need a merge conflict resolution or rebase.

Closes # (no related issue)

alt-glitch and others added 5 commits April 30, 2026 00:49
…y dependency

Complete rewrite of the ComfyUI skill to use:
- comfy-cli (official, Comfy-Org/comfy-cli) for lifecycle management:
  install, launch, stop, node management, model downloads
- Direct REST API + helper scripts for workflow execution:
  parameter injection, submission, monitoring, output download
- No dependency on comfyui-skill-cli or any unofficial tool

New files:
- SKILL.md: full rewrite with two-layer architecture, decision tree, pitfalls
- references/official-cli.md: complete comfy-cli command reference
- references/rest-api.md: all REST endpoints (local + cloud)
- references/workflow-format.md: API format spec, common nodes, param mapping
- scripts/extract_schema.py: analyze workflow → extract controllable params
- scripts/run_workflow.py: inject args, submit, poll, download outputs
- scripts/check_deps.py: check missing nodes/models against running server
- scripts/comfyui_setup.sh: full setup automation with official CLI

Removed:
- references/cli-reference.md (was for unofficial comfyui-skill-cli)
- references/api-notes.md (replaced by rest-api.md)

Addresses feedback from PR #17316 comment:
- Correct author attribution
- Remove references to unofficial OpenClaw project
- License field reflects hermes-agent repo (MIT)
…links, cloud setup

Adds structured onboarding flow to SKILL.md:
- Decision table: which install path for which situation
- Path A: Comfy Cloud (zero setup, API key, pricing)
- Path B: Desktop app (Windows/macOS, one-click)
- Path C: Portable build (Windows, extract-and-run)
- Path D: comfy-cli (recommended for agents, all platforms)
- Path E: Manual install (advanced, all hardware types)
- Post-install: model downloads, custom nodes, verification

All paths link to official docs:
- https://docs.comfy.org/installation
- https://docs.comfy.org/comfy-cli/getting-started
- https://docs.comfy.org/get_started/cloud
- https://docs.comfy.org/installation/desktop
- https://docs.comfy.org/installation/comfyui_portable_windows
- https://docs.comfy.org/installation/manual_install
…ring sanitization'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…ring sanitization'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…to onboarding

Instead of asking the user what they have, the agent now:
1. Runs system detection commands (OS, GPU, VRAM, RAM, disk, Python)
2. Checks if ComfyUI is already installed/running
3. Recommends the best path based on findings

Adds:
- Step 1: detection script block (nvidia-smi, system_profiler, etc.)
- Step 2: decision table mapping detected system → recommended path
- Hardware requirements table (VRAM tiers, RAM, disk)
- Specific recommendations per platform:
  macOS → Desktop app, Linux+NVIDIA → comfy-cli, no GPU → Cloud, etc.
@daimon-nous daimon-nous Bot added type/docs Documentation improvements P3 Low — cosmetic, nice to have labels May 15, 2026
@daimon-nous

daimon-nous Bot commented May 15, 2026

Copy link
Copy Markdown
Contributor

@christian-byrne Tagging you on this ComfyUI item.

@Master-Rensei Master-Rensei closed this by deleting the head repository May 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants