cli-anything-comfyui은(는) 무엇을 하나요?
ComfyUI REST API를 통한 AI 이미지 생성 워크플로우 관리. GUI 없이 워크플로우를 큐에 추가하고, 모델을 관리하고, 생성된 이미지를 다운로드하며, 생성 큐를 모니터링해야 하는 AI 에이전트 및 고급 사용자를 위해 설계되었습니다.
설치
이 CLI는 cli-anything-comfyui 패키지의 일부로 설치됩니다:
pip install cli-anything-comfyui
사전 요구 사항:
- Python 3.10+
- ComfyUI가 설치되어 http://localhost:8188 에서 실행 중이어야 합니다.
사용법
기본 명령어
# 도움말 표시
cli-anything-comfyui --help
# 대화형 REPL 모드 시작
cli-anything-comfyui repl
# 서버 상태 확인
cli-anything-comfyui system stats
# JSON 출력으로 실행 (에이전트 소비용)
cli-anything-comfyui --json system stats
REPL 모드
탐색적 사용을 위한 대화형 세션 시작:
cli-anything-comfyui repl
# 탭 완성 및 기록 기능과 함께 대화형 명령어 입력
명령어 그룹
Workflow
워크플로우 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
list | 저장된 워크플로우 목록 표시 |
load | JSON 파일에서 워크플로우 로드 |
validate | ComfyUI 노드 그래프에 대한 워크플로우 JSON 유효성 검사 |
Queue
생성 큐 관리.
| 명령어 | 설명 |
|---|---|
prompt | 워크플로우 실행 큐에 추가 |
status | 현재 큐 상태 표시 (실행 중 및 대기 중) |
clear | 생성 큐 지우기 |
history | 프롬프트 실행 기록 표시 |
interrupt | 현재 실행 중인 생성 중단 |
Models
모델 검색 명령어.
| 명령어 | 설명 |
|---|---|
checkpoints | 사용 가능한 체크포인트 모델 목록 표시 |
loras | 사용 가능한 LoRA 모델 목록 표시 |
vaes | 사용 가능한 VAE 모델 목록 표시 |
controlnets | 사용 가능한 ControlNet 모델 목록 표시 |
node-info | 특정 노드 유형의 상세 정보 표시 |
list-nodes | 사용 가능한 모든 노드 유형 목록 표시 |
Images
생성된 이미지 관리.
| 명령어 | 설명 |
|---|---|
list | 서버에 생성된 이미지 목록 표시 |
download | 특정 생성 이미지 다운로드 |
download-all | 프롬프트 실행의 모든 이미지 다운로드 |
System
서버 상태 및 정보.
| 명령어 | 설명 |
|---|---|
stats | ComfyUI 시스템 통계 표시 (GPU, CPU, 메모리) |
info | ComfyUI 서버 정보 및 확장 기능 표시 |
예제
시스템 상태 확인
# 서버 통계
cli-anything-comfyui system stats
# 서버 정보
cli-anything-comfyui system info
사용 가능한 모델 검색
# 체크포인트 목록
cli-anything-comfyui models checkpoints
# LoRA 목록
cli-anything-comfyui models loras
# 모든 노드 유형 목록
cli-anything-comfyui models list-nodes
생성 큐 추가 및 모니터링
# 워크플로우 큐에 추가
cli-anything-comfyui queue prompt --workflow my_workflow.json
# 큐 상태 확인
cli-anything-comfyui queue status
# 실행 기록 보기
cli-anything-comfyui --json queue history
생성된 이미지 다운로드
# 생성된 이미지 목록
cli-anything-comfyui images list
# 특정 이미지 다운로드
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png
# 프롬프트의 모든 이미지 다운로드
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./outputs
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽기 쉬운 (기본값): 표, 색상, 형식화된 텍스트
- 기계가 읽기 쉬운 (
--json플래그): 에이전트 소비용 구조화된 JSON
# 사람용 출력
cli-anything-comfyui system stats
# 에이전트용 JSON 출력
cli-anything-comfyui --json system stats
AI 에이전트용
이 CLI를 프로그래밍 방식으로 사용할 때:
- 항상
--json플래그 사용하여 파싱 가능한 출력을 확보하세요. - 반환 코드 확인 - 0은 성공, 0이 아닌 값은 오류를 나타냅니다.
- 실패 시 오류 메시지를 위해 stderr 구문 분석
- 모든 파일 작업에 절대 경로 사용
- 다른 명령어 전에
system stats로 ComfyUI가 실행 중인지 확인
추가 정보
- 전체 문서: 패키지의 README.md 참조
- 테스트 범위: 패키지의 TEST.md 참조
- 방법론: cli-anything-plugin의 HARNESS.md 참조
버전
1.0.0