MieMieeeee/comfyui-agent-skill

comfyui-agent-skill은(는) 무엇을 하나요?

에이전트가 이 저장소의 CLI를 통해 로컬 ComfyUI 서버에서 등록된 워크플로우를 실행하고 구조화된 JSON 결과를 반환할 수 있도록 합니다.

개요

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 로컬 ComfyUI 인스턴스와 상호작용할 수 있게 해줍니다. 워크플로우를 사전 등록하고 간단한 CLI 명령어로 실행하면, 결과가 구조화된 JSON 형식으로 반환되어 에이전트가 추가 처리를 쉽게 할 수 있습니다.

설치

git clone https://github.com/MieMieeeee/comfyui-agent-skill.git
cd comfyui-agent-skill
pip install -r requirements.txt

설정

1. 로컬 ComfyUI 서버가 실행 중인지 확인하세요.
2. .env 파일을 생성하고 ComfyUI 서버 URL을 설정하세요:

   COMFYUI_SERVER_URL=http://localhost:8188
   

3. 사용할 워크플로우를 workflows/ 디렉토리에 등록하세요. 각 워크플로우는 JSON 파일로 정의됩니다.

사용법

워크플로우 실행

python run_workflow.py --workflow workflow_name [--param key=value ...]

예시:

python run_workflow.py --workflow text_to_image --param prompt="a cat" --param steps=20

등록된 워크플로우 목록 보기

python run_workflow.py --list

결과 확인

실행이 완료되면, 결과는 outputs/ 디렉토리에 저장되며 CLI는 다음과 같은 구조화된 JSON을 반환합니다:

{
  "status": "success",
  "workflow": "text_to_image",
  "output_files": ["outputs/generated_20250321_123456.png"],
  "metadata": {
    "execution_time": 5.23,
    "parameters": {
      "prompt": "a cat",
      "steps": 20
    }
  }
}

워크플로우 등록

워크플로우를 등록하려면 workflows/ 디렉토리에 JSON 파일을 생성하세요. 각 파일은 다음 구조를 따라야 합니다:

{
  "name": "text_to_image",
  "description": "텍스트 프롬프트에서 이미지 생성",
  "workflow_api": {
    "3": {
      "inputs": {
        "seed": 0,
        "steps": 20,
        "cfg": 8,
        "sampler_name": "euler",
        "scheduler": "normal",
        "denoise": 1,
        "model": ["4", 0],
        "positive": ["6", 0],
        "negative": ["7", 0],
        "latent_image": ["5", 0]
      },
      "class_type": "KSampler"
    },
    "parameters": {
      "prompt": {
        "node_id": 6,
        "field": "text"
      },
      "steps": {
        "node_id": 3,
        "field": "steps"
      }
    },
    "outputs": {
      "images": {
        "node_id": 9,
        "field": "images"
      }
    }
  }
}

parameters 필드는 CLI를 통해 오버라이드할 수 있는 입력을 정의합니다. outputs 필드는 결과 JSON에 포함될 출력을 정의합니다.

지원 플랫폼

• 로컬 ComfyUI 서버 (Python 3.8+)
• AI 에이전트: Claude Code, Cursor, Codex 등 CLI 명령어를 실행할 수 있는 모든 에이전트

라이선스

MIT