# ComfyUI Generation

Generate images, video and audio through ComfyUI diffusion workflows.

- Repository: https://github.com/NousResearch/hermes-agent (259479 stars)
- Category: Media
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add NousResearch/hermes-agent --skill comfyui -g -a claude-code -y`
Codex: `npx skills add NousResearch/hermes-agent --skill comfyui -g -a codex -y`
Cursor: `npx skills add NousResearch/hermes-agent --skill comfyui -g -a cursor -y`
Gemini CLI: `npx skills add NousResearch/hermes-agent --skill comfyui -g -a gemini-cli -y`

## Description

Generate images, video, and audio via diffusion workflows.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ComfyUI

Generate images, video, audio, and 3D content through ComfyUI using the
official `comfy-cli` for setup/lifecycle and direct REST/WebSocket API
for workflow execution.

## What's in this skill

**Reference docs (`references/`):**

- `official-cli.md`, every `comfy ...` command, with flags
- `rest-api.md`, REST + WebSocket endpoints (local + cloud), payload schemas
- `workflow-format.md`, API-format JSON, common node types, param mapping
- `template-integrity.md`, converting `comfyui-workflow-templates` from
  editor format to API format: Reroute bypass, dotted dynamic-input keys
  (`values.a`, `resize_type.width`), Cloud quirks (302 redirect, 1 concurrent
  free-tier job, 1080p VRAM ceiling), Discord-compatible ffmpeg stitch.
  Authored by [@purzbeats](https://github.com/purzbeats). Load this whenever
  you're starting from an official template.

**Scripts (`scripts/`):**

| Script | Purpose |
|--------|---------|
| `_common.py` | Shared HTTP, cloud routing, node catalogs (don't run directly) |
| `hardware_check.py` | Probe GPU/VRAM/disk → recommend local vs Comfy Cloud |
| `comfyui_setup.sh` | Hardware check + comfy-cli + ComfyUI install + launch + verify |
| `extract_schema.py` | Read a workflow → list controllable params + model deps |
| `check_deps.py` | Check workflow against running server → list missing nodes/models |
| `auto_fix_deps.py` | Run check_deps then `comfy node install` / `comfy model download` |
| `run_workflow.py` | Inject params, submit, monitor, download outputs (HTTP or WS) |
| `run_batch.py` | Submit a workflow N times with sweeps, parallel up to your tier |
| `ws_monitor.py` | Real-time WebSocket viewer for executing jobs (live progress) |
| `health_check.py` | Verification checklist runner, comfy-cli + server + models + smoke test |
| `fetch_logs.py` | Pull traceback / status messages for a given prompt_id |

The rest: https://github.com/NousResearch/hermes-agent/blob/HEAD/optional-skills/creative/comfyui/SKILL.md