cli-anything-comfyui 是做什么的?
通过ComfyUI REST API进行AI图像生成工作流管理。专为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
# 以交互方式输入命令,支持Tab补全和历史记录
命令组
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表示成功,非零表示错误
- 解析stderr 以获取失败时的错误信息
- 使用绝对路径 进行所有文件操作
- 验证ComfyUI正在运行,在执行其他命令前使用
system stats
更多信息
- 完整文档:参见包中的README.md
- 测试覆盖:参见包中的TEST.md
- 方法论:参见cli-anything-plugin中的HARNESS.md
版本
1.0.0