Baidu Meux ComfyTools

English | 中文

---

English

Overview

Baidu Meux ComfyTools is a collection of custom nodes that streamline common workflow chores in ComfyUI for the Baidu Meux asset platform.
Current version: 1.2.0

• MeuxMultiSaveImage: save up to sixteen image batches with optional resizing.
• MeuxAdvancedImageCrop: crop images by pixels or percentage with optional grid alignment.
• MeuxSimpleLLMNode: call an external chat-completions style LLM API directly inside a workflow.
• MeuxImageLoader: drop-in replacement for ComfyUI's Load Image node with optional HTTP/HTTPS downloading and persistence to the input folder.

The package now uses a modular nodes/ directory so each node is easy to maintain and extend.

Changelog

• v1.2.0
  • Introduced MeuxImageLoader, a drop-in replacement for ComfyUI's Load Image with URL downloading.
• v1.1.0
  • Restructured package into modular node files under nodes/.
  • Added MeuxAdvancedImageCrop and MeuxSimpleLLMNode registrations to the public export.
  • Updated documentation with usage guides for every node.
• v1.0.0
  • Initial release with the MeuxMultiSaveImage node.

Installation / Update

1. Clone or download into your ComfyUI custom node folder:

   cd ComfyUI/custom_nodes/
   git clone https://github.com/yourusername/Baidu_Meux_ComfyTools.git
   

2. For updates, pull the latest changes:

   cd ComfyUI/custom_nodes/Baidu_Meux_ComfyTools
   git pull
   

3. Restart ComfyUI. The nodes appear under the image, Image/Transform, and LLM categories.

Usage Tutorial

MeuxImageLoader

1. Set source_type:
   • local: behaves exactly like the stock Load Image node; pick any file under ComfyUI/input.
   • url: paste an HTTP/HTTPS link to download on the fly.
2. Optional controls:
   • filename_hint: suggest the persisted filename; falls back to a hash of the URL.
   • persist_to_input: keep a copy in ComfyUI/input so other nodes can reference it by name.
   • overwrite_existing: replace an existing file instead of auto-appending numeric suffixes.
   • download_timeout, max_download_mb, verify_ssl: guardrails for network transfers.
3. Run the node to receive the image tensor plus the derived MASK (alpha or grayscale channel when available), making it a drop-in replacement for ComfyUI's default loader.

MeuxMultiSaveImage

1. Connect one or more IMAGE tensors to images_1 … images_16. Batches are split automatically.
2. Set filename_prefix (unsafe characters are cleaned automatically).
3. Optional toggles:
   • save_individually: keep the sequential counter for each input image.
   • resize_to_same: rescale every image to target_width × target_height using Lanczos.
4. Run the node. Images are written to the ComfyUI output directory as
   prefix_{slotIndex:03d}_{counter:05d}.png, and UI metadata is returned for gallery preview.

MeuxAdvancedImageCrop

1. Feed an IMAGE tensor into image.
2. Choose measurement mode:
   • Pixels: specify absolute crop margins.
   • Percentage: margins are interpreted relative to current width/height.
3. Optionally snap the crop window by setting align_to to 8 or 16.
4. Execute to obtain the cropped tensor (with console logging of the crop result).

MeuxSimpleLLMNode

1. Provide your API key and endpoint (api_url defaults to siliconflow chat completions).
2. Set the model identifier supported by your provider.
3. Enter the user_prompt; optionally supply a system_prompt and sampling parameters (temperature, top_p, top_k, penalties).
4. Run the node. The main output is the assistant message, along with the full JSON payload and token usage.

Folder Structure

Baidu_Meux_ComfyTools/
├── __init__.py          # Registers all exposed nodes
└── nodes/
    ├── image_loader.py
    ├── advanced_image_crop.py
    ├── multi_save_image.py
    └── simple_llm_node.py

Requirements

• ComfyUI
• PyTorch
• Pillow
• NumPy
• Requests (required by MeuxSimpleLLMNode and MeuxImageLoader)

License & Support

Licensed under the MIT License.
Issues and feature requests: GitHub Issues.

---

中文

概述

Baidu Meux ComfyTools 是一组面向百度 Meux 资产平台、帮助简化 ComfyUI 工作流的自定义节点。
当前版本：1.2.0

• MeuxMultiSaveImage：一次保存最多 16 组图像，支持可选统一尺寸。
• MeuxAdvancedImageCrop：按像素或百分比裁剪，可选择 8/16 像素对齐。
• MeuxSimpleLLMNode：在工作流中调用外部 LLM Chat Completion 接口。
• MeuxImageLoader：兼容本地/URL 两种来源，可选写入 input 目录，完全替换原生 Load Image 节点。

项目已改用模块化的 nodes/ 目录，便于后续维护与扩展。

更新日志

• v1.2.0
  • 新增 MeuxImageLoader，支持 URL 下载、可完全替换原生 Load Image。
• v1.1.0
  • 重构包结构至 nodes/ 子目录。
  • 注册 MeuxAdvancedImageCrop 与 MeuxSimpleLLMNode 节点。
  • 文档新增全部节点的使用教程。
• v1.0.0
  • 发布 MeuxMultiSaveImage 节点初版。

安装 / 更新

1. 克隆或下载到 ComfyUI 自定义节点目录：

   cd ComfyUI/custom_nodes/
   git clone https://github.com/yourusername/Baidu_Meux_ComfyTools.git
   

2. 更新时执行：

   cd ComfyUI/custom_nodes/Baidu_Meux_ComfyTools
   git pull
   

3. 重启 ComfyUI，节点将出现在 image、Image/Transform 与 LLM 分类下。

使用教程

MeuxImageLoader

1. 选择 source_type：
   • local：与原生 Load Image 完全一致，从 ComfyUI/input 选择文件。
   • url：粘贴 HTTP/HTTPS 图片地址，节点会在运行时自动下载。
2. 可选参数：
   • filename_hint：为持久化的文件提供自定义名称，默认使用 URL 哈希。
   • persist_to_input：勾选后会把下载结果写入 ComfyUI/input 以供其他节点复用。
   • overwrite_existing：允许覆盖同名文件，否则自动追加序号。
   • download_timeout、max_download_mb、verify_ssl：用于限制下载时间、大小与验证方式。
3. 运行后输出图片张量与 MASK（若原图包含 Alpha 或灰度通道），可直接替换 ComfyUI 自带的 Load Image 节点。

MeuxMultiSaveImage

1. 将一张或多张 IMAGE 张量连接到 images_1 … images_16，批次会自动拆分。
2. 设置 filename_prefix（系统会自动清理危险字符）。
3. 可选项：
   • save_individually：为每张图单独编号。
   • resize_to_same：按 target_width × target_height 使用 Lanczos 算法统一尺寸。
4. 运行后，图像保存到 ComfyUI 输出目录，命名格式
   前缀_{输入序号:03d}_{计数:05d}.png，同时返回 UI 预览信息。

MeuxAdvancedImageCrop

1. 将 IMAGE 张量接入 image。
2. 选择 measurement 模式：
   • Pixels：输入像素裁剪边距。
   • Percentage：边距按当前宽/高的百分比计算。
3. 如需像素对齐，将 align_to 设为 8 或 16。
4. 运行节点即可得到裁剪后的图像，并在控制台查看裁剪日志。

MeuxSimpleLLMNode

1. 输入可用的 API Key 和接口地址（默认指向 siliconflow chat completions）。
2. 设置服务商支持的 model 名称。
3. 填写 user_prompt；根据需要添加 system_prompt 和采样参数（temperature、top_p、top_k、惩罚项）。
4. 执行节点将返回：
   • 主输出：模型回复文本；
   • 附加输出：完整 JSON 响应与消耗的 token 数。

目录结构

Baidu_Meux_ComfyTools/
├── __init__.py          # 节点入口注册
└── nodes/
    ├── image_loader.py
    ├── advanced_image_crop.py
    ├── multi_save_image.py
    └── simple_llm_node.py

依赖

• ComfyUI
• PyTorch
• Pillow
• NumPy
• Requests（供 MeuxSimpleLLMNode 与 MeuxImageLoader 访问 HTTP 接口）

许可证与支持

采用 MIT 许可证。
问题反馈与功能建议： GitHub Issues。