mcpField
C
cli-anything-comfyui

cli-anything-comfyui

github.com/hkuds创意与媒体57.6k556 次安装5 周前更新
代码仓库

关于 cli-anything-comfyui

cli-anything-comfyui 是面向 AI Agent 和高级用户的命令行工具，通过 ComfyUI REST API 管理图像生成工作流。它支持队列监控、模型查看和图像下载，并提供适合 Agent 解析的 JSON 输出。

主要功能

  1. 01创建和校验工作流
  2. 02提交及监控生成队列
  3. 03查看模型与节点信息
  4. 04列出并下载生成图像
  5. 05查询服务器状态和资源使用

适用场景

  1. 01通过命令行提交图像生成任务
  2. 02检查待处理任务和执行历史
  3. 03查找可用模型或节点类型
  4. 04下载指定任务生成的图像

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-comfyui

安装后在 Claude Code 中输入/cli-anything-comfyui确认已加载。

详细介绍

cli-anything-comfyui

通过 ComfyUI REST API 进行 AI 图像生成工作流管理。专为需要在无 GUI 环境下排队工作流、管理模型、下载生成的图像并监控生成队列的 AI Agent 和高级用户而设计。

安装

此命令行工具作为 cli-anything-comfyui 包的一部分安装：

pip install cli-anything-comfyui

前置条件：

用法

基本命令
# Show help
cli-anything-comfyui --help

# Start interactive REPL mode
cli-anything-comfyui repl

# Check server stats
cli-anything-comfyui system stats

# Run with JSON output (for agent consumption)
cli-anything-comfyui --json system stats
REPL 模式

启动交互式会话以进行探索性使用：

cli-anything-comfyui repl
# Enter commands interactively with tab-completion and history

命令组

Workflow

工作流管理命令。

命令描述
list列出已保存的工作流
load从 JSON 文件加载工作流
validate根据 ComfyUI 节点图验证工作流 JSON
Queue

生成队列管理。

命令描述
prompt将工作流排队以执行
status显示当前队列状态（运行中和待处理）
clear清空生成队列
history显示提示词执行历史
interrupt中断当前正在运行的生成
Models

模型发现命令。

命令描述
checkpoints列出可用的 checkpoint 模型
loras列出可用的 LoRA 模型
vaes列出可用的 VAE 模型
controlnets列出可用的 ControlNet 模型
node-info显示特定节点类型的详细信息
list-nodes列出所有可用的节点类型
Images

生成的图像管理。

命令描述
list列出服务器上生成的图像
download下载特定的生成图像
download-all下载一次提示词执行生成的所有图像
System

服务器状态和信息。

命令描述
stats显示 ComfyUI 系统统计信息（GPU、CPU、内存）
info显示 ComfyUI 服务器信息和扩展

示例

检查系统状态
# Server stats
cli-anything-comfyui system stats

# Server info
cli-anything-comfyui system info
发现可用模型
# List checkpoints
cli-anything-comfyui models checkpoints

# List LoRAs
cli-anything-comfyui models loras

# List all node types
cli-anything-comfyui models list-nodes
排队并监控生成
# Queue a workflow
cli-anything-comfyui queue prompt --workflow my_workflow.json

# Check queue status
cli-anything-comfyui queue status

# View execution history
cli-anything-comfyui --json queue history
下载生成的图像
# List generated images
cli-anything-comfyui images list

# Download a specific image
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png

# Download all images from a prompt
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./outputs

输出格式

所有命令支持两种输出模式：

  • 人类可读（默认）：表格、颜色、格式化文本
  • 机器可读（--json 标志）：供 Agent 使用的结构化 JSON
# Human output
cli-anything-comfyui system stats

# JSON output for agents
cli-anything-comfyui --json system stats

面向 AI Agent

以编程方式使用此命令行工具时：

  1. 始终使用 --json 标志以获得可解析的输出
  2. 检查返回码 - 0 表示成功，非零表示错误
  3. 解析 stderr 以获取失败时的错误消息
  4. 使用绝对路径进行所有文件操作
  5. 在执行其他命令之前，使用 system stats 验证 ComfyUI 正在运行

更多信息

  • 完整文档：参见包中的 README.md
  • 测试覆盖率：参见包中的 TEST.md
  • 方法论：参见 cli-anything-plugin 中的 HARNESS.md

版本

1.0.0

评论

支持 Markdown