什么是ComfyUI
ComfyUI Runner 是一个专为本地 ComfyUI 工作流设计的自动化执行工具，通过标准化的 HTTP API 接口与运行在 127.0.0.1:8188 上的 ComfyUI 服务器通信，实现图像生成任务的提交与结果获取。其核心职责在于接收用户指定的工作流文件路径或默认配置，解析其中的 JSON 结构，并根据用户需求动态调整关键参数（如提示词、风格前缀和随机种子），随后将修改后的工作流提交至 ComfyUI 服务器执行，最终将生成的图像文件返回给用户。该工具特别适用于需要通过自然语言指令触发复杂 AI 图像生成流程的场景，例如根据文字描述生成特定风格的图片。它不负责模型管理或服务器部署，仅聚焦于工作流的调度与输出交付，因此要求用户已正确安装并启动 ComfyUI 环境。整个交互过程以 JSON 格式进行数据交换，确保了系统间的解耦与灵活性。
核心功能特点
- 支持通过编辑工作流 JSON 文件自定义生成提示词、风格和随机种子
- 自动识别并处理 prompt 节点、CLIPTextEncode 等关键输入字段
- 提供模型权重 URL 批量下载功能，自动归类到 ComfyUI models 子目录
- 内置 pget 并行下载支持，未安装时自动部署 fallback 机制
- 严格遵循输出交付规范，确保用户始终收到生成的图像文件
适用场景
该工具主要面向需要频繁调用 ComfyUI 进行图像创作的开发者、艺术家或内容创作者。典型使用场景包括：用户希望通过自然语言描述生成一张具有特定构图、光影效果或艺术风格的图片，此时系统会读取默认或指定工作流，将用户输入的文本转化为图像提示词填入相应节点，然后提交执行；当用户希望批量生成不同风格的同一主题图像时，可通过修改 seed 值和工作流参数实现多样化输出；此外，若用户提供了外部模型文件的下载链接（如 LoRA 或 ControlNet 模型），工具能自动将其保存到正确的模型目录，避免手动干预。所有操作均在本地完成，保障了数据隐私性，同时依赖成熟的 ComfyUI 生态支持丰富的节点组合与扩展能力。