MeuxImageLoader: load an image from ComfyUI/input or an HTTP/HTTPS URL.
MeuxMaskLoader: load a mask from ComfyUI/input or an HTTP/HTTPS URL and align it to a reference image.
MeuxMaskFillHoles: fill enclosed holes in a mask.
MeuxMaskBlurPlus: blur or feather a mask.
MeuxSeed: workflow-compatible seed passthrough node.
MeuxMultiSaveImage: save up to sixteen image batches with optional resizing.
MeuxAdvancedImageCrop: crop images by pixels or percentage with optional alignment.
MeuxSimpleLLMNode: call a chat-completions style LLM API inside a workflow.
MeuxTextAreaInput: multi-line text input helper.
MeuxArtisticTextPreview: advanced transparent text preview with fill, outline, spacing, shadow, glow, and mask output.
MeuxSmartEmptyLatent: generate a safe-sized empty latent tensor.
MeuxSizePresetSafe: compute aligned generation sizes.
MeuxOutpaintSizePresetSafe: compute safe per-side outpaint expansion sizes.
MeuxSmartExactResize: crop or pad to an exact target size.
MeuxRMBG: BiRefNet-based background removal.
MeuxRealESRGANUpscale: local RealESRGAN upscaling.

Workflow-compatible aliases:

Mask Fill Holes
MaskBlur+
Seed

Changelog

v1.6.0
- Added MeuxMaskLoader as a dedicated mask-loading node.
- Added workflow-compatible mask utility nodes: MeuxMaskFillHoles, MeuxMaskBlurPlus, MeuxSeed.
- Registered compatibility aliases: Mask Fill Holes, MaskBlur+, Seed.
- Added scipy dependency for hole-filling behavior aligned with upstream workflows.
v1.5.0
- Added MeuxRMBG for local/remote BiRefNet background removal.
- Added MeuxRealESRGANUpscale for local RealESRGAN upscaling.
v1.4.0
- Added MeuxOutpaintSizePresetSafe.
- Capped size-related inputs at 4096.
v1.3.0
- Added MeuxSmartEmptyLatent, MeuxSizePresetSafe, and MeuxSmartExactResize.
v1.2.0
- Added MeuxImageLoader with URL downloading support.
v1.1.0
- Restructured the package into modular files under nodes/.
v1.0.0
- Initial release with MeuxMultiSaveImage.

Installation / Update

Clone into ComfyUI/custom_nodes/:

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

Update when needed:

cd ComfyUI/custom_nodes/Baidu_Meux_ComfyTools
git pull

Install dependencies:

cd ComfyUI/custom_nodes/Baidu_Meux_ComfyTools
pip install -r requirements.txt

Restart ComfyUI.

Quick Usage

MeuxImageLoader

source_type = local: select a file from ComfyUI/input
source_type = url: download from an HTTP/HTTPS URL
Outputs IMAGE and the derived mask from alpha or grayscale when present

MeuxMaskLoader

reference_image is required so the mask can match the image size
source_type = local | url
Supports mask_channel, mask_invert, and resize_to_reference
Outputs native ComfyUI-style MASK

Recommended pairing:

MeuxImageLoader.image -> downstream image pipeline
MeuxImageLoader.image -> MeuxMaskLoader.reference_image
MeuxMaskLoader.mask -> downstream mask pipeline

Workflow-Compatible Mask Nodes

MeuxMaskFillHoles / Mask Fill Holes: fill enclosed regions inside a mask
MeuxMaskBlurPlus / MaskBlur+: feather a mask
MeuxSeed / Seed: expose a workflow-compatible seed value

Other Utility Nodes

MeuxMultiSaveImage: batch image saving
MeuxAdvancedImageCrop: crop by pixels or percentage
MeuxSimpleLLMNode: direct LLM API calls
MeuxTextAreaInput: long prompt input
MeuxArtisticTextPreview: advanced transparent text preview with optional gradient fill, outline, shadow, inner shadow, glow, and mask output
MeuxSmartEmptyLatent: safe latent initialization
MeuxSizePresetSafe: safe size planning
MeuxOutpaintSizePresetSafe: safe outpaint size planning
MeuxSmartExactResize: exact resize with crop/pad logic
MeuxRMBG: local background removal
MeuxRealESRGANUpscale: local image upscaling

MeuxArtisticTextPreview

Outputs a transparent IMAGE preview and a matching MASK
Reads fonts from Baidu_Meux_ComfyTools/fonts first, then falls back to bundled/system fonts
Supports fixed and fit font sizing modes
Supports font_name, char_spacing, bold, and italic
Supports solid or gradient fill
Supports solid or gradient outline
Supports shadow, inner shadow, and outer glow
Supports transparent or colored preview backgrounds

Recommended first test:

Add MeuxArtisticTextPreview
Set text = Hello
Set font_size_mode = fixed
Set font_size = 128
Enable outline_enabled
Connect the image output to a preview or save node

Folder Structure

Baidu_Meux_ComfyTools/
├── __init__.py
├── pyproject.toml
├── requirements.txt
└── nodes/
    ├── advanced_image_crop.py
    ├── image_loader.py
    ├── mask_blur_plus.py
    ├── mask_fill_holes.py
    ├── mask_loader.py
    ├── artistic_text_preview.py
    ├── multi_save_image.py
    ├── outpaint_size_preset_safe.py
    ├── realesrgan_upscale.py
    ├── rmbg_birefnet.py
    ├── seed_node.py
    ├── simple_llm_node.py
    ├── size_preset_safe.py
    ├── smart_empty_latent.py
    ├── smart_exact_resize.py
    └── text_area_input.py

Requirements

ComfyUI
PyTorch
Pillow
NumPy
Requests
transformers
torchvision
realesrgan
scipy

Support

Repository: fchangjun/Baidu_Meux_ComfyTools
Issues: GitHub Issues

中文

概述

Baidu Meux ComfyTools 是一组用于 ComfyUI 的自定义节点，服务于百度 Meux 资产平台相关工作流。
当前版本：1.6.0

主要节点：

MeuxImageLoader：从 ComfyUI/input 或 HTTP/HTTPS URL 加载图片
MeuxMaskLoader：从 ComfyUI/input 或 HTTP/HTTPS URL 加载遮罩，并对齐到参考图尺寸
MeuxMaskFillHoles：填充遮罩内部封闭空洞
MeuxMaskBlurPlus：对遮罩做模糊/羽化
MeuxSeed：兼容工作流的种子透传节点
MeuxMultiSaveImage：一次保存最多 16 组图像，可选统一尺寸
MeuxAdvancedImageCrop：按像素或百分比裁剪图像
MeuxSimpleLLMNode：在工作流中调用聊天式 LLM 接口
MeuxTextAreaInput：多行文本输入辅助节点
MeuxArtisticTextPreview：在透明画布上渲染高级文字预览，支持填充、描边、字距、阴影、内阴影、外发光，并输出遮罩
MeuxSmartEmptyLatent：生成安全尺寸的空白 latent
MeuxSizePresetSafe：计算安全生成尺寸
MeuxOutpaintSizePresetSafe：计算安全外扩尺寸
MeuxSmartExactResize：精确尺寸裁剪/补边
MeuxRMBG：基于 BiRefNet 的抠图节点
MeuxRealESRGANUpscale：本地 RealESRGAN 放大节点

工作流兼容别名：

Mask Fill Holes
MaskBlur+
Seed

更新日志

v1.6.0
- 新增独立遮罩加载节点 MeuxMaskLoader
- 新增工作流兼容节点 MeuxMaskFillHoles、MeuxMaskBlurPlus、MeuxSeed
- 注册兼容别名 Mask Fill Holes、MaskBlur+、Seed
- 新增 scipy 依赖，用于按上游逻辑填充遮罩空洞
v1.5.0
- 新增 MeuxRMBG，支持本地/远端 BiRefNet 抠图
- 新增 MeuxRealESRGANUpscale，支持本地 RealESRGAN 放大
v1.4.0
- 新增 MeuxOutpaintSizePresetSafe
- 尺寸相关输入上限统一为 4096
v1.3.0
- 新增 MeuxSmartEmptyLatent、MeuxSizePresetSafe、MeuxSmartExactResize
v1.2.0
- 新增 MeuxImageLoader，支持 URL 下载
v1.1.0
- 重构为 nodes/ 模块化结构
v1.0.0
- 发布 MeuxMultiSaveImage 初版

安装 / 更新

克隆到 ComfyUI/custom_nodes/：

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

更新代码：

cd ComfyUI/custom_nodes/Baidu_Meux_ComfyTools
git pull

安装依赖：

cd ComfyUI/custom_nodes/Baidu_Meux_ComfyTools
pip install -r requirements.txt

重启 ComfyUI。

快速使用

MeuxImageLoader

source_type = local：从 ComfyUI/input 选择本地文件
source_type = url：运行时下载 HTTP/HTTPS 图片
输出 IMAGE，以及图片自带 alpha/灰度派生的 MASK

MeuxMaskLoader

必须连接 reference_image，用于保证遮罩尺寸和原图一致
source_type = local | url
支持 mask_channel、mask_invert、resize_to_reference
输出原生兼容的 MASK

推荐连法：

MeuxImageLoader.image 接图像处理链路
MeuxImageLoader.image 接 MeuxMaskLoader.reference_image
MeuxMaskLoader.mask 接遮罩处理链路

工作流兼容遮罩节点

MeuxMaskFillHoles / Mask Fill Holes：填充遮罩内部封闭区域
MeuxMaskBlurPlus / MaskBlur+：做遮罩羽化
MeuxSeed / Seed：输出兼容工作流的 seed

其他工具节点

MeuxMultiSaveImage：批量保存图片
MeuxAdvancedImageCrop：按像素或百分比裁剪
MeuxSimpleLLMNode：直接调用 LLM API
MeuxTextAreaInput：长文本输入
MeuxArtisticTextPreview：高级透明文字预览节点，支持渐变填充、描边、字距、阴影、内阴影、外发光和遮罩输出
MeuxSmartEmptyLatent：安全 latent 初始化
MeuxSizePresetSafe：安全尺寸规划
MeuxOutpaintSizePresetSafe：安全外扩尺寸规划
MeuxSmartExactResize：精确尺寸裁剪/补边
MeuxRMBG：本地抠图
MeuxRealESRGANUpscale：本地放大

MeuxArtisticTextPreview

输出透明背景 IMAGE 预览图，以及对应的 MASK
优先读取 Baidu_Meux_ComfyTools/fonts 目录中的字体，再回退到内置字体和系统字体
支持 fixed 和 fit 两种字号模式
支持 font_name、char_spacing、bold、italic
支持纯色或渐变填充
支持纯色或渐变描边
支持阴影、内阴影、外发光
支持透明或纯色背景预览

建议先用下面这组参数测试：

添加 MeuxArtisticTextPreview
设置 text = Hello
设置 font_size_mode = fixed
设置 font_size = 128
打开 outline_enabled
将 image 输出连接到预览或保存节点

目录结构

Baidu_Meux_ComfyTools/
├── __init__.py
├── pyproject.toml
├── requirements.txt
└── nodes/
    ├── advanced_image_crop.py
    ├── image_loader.py
    ├── mask_blur_plus.py
    ├── mask_fill_holes.py
    ├── mask_loader.py
    ├── artistic_text_preview.py
    ├── multi_save_image.py
    ├── outpaint_size_preset_safe.py
    ├── realesrgan_upscale.py
    ├── rmbg_birefnet.py
    ├── seed_node.py
    ├── simple_llm_node.py
    ├── size_preset_safe.py
    ├── smart_empty_latent.py
    ├── smart_exact_resize.py
    └── text_area_input.py

依赖

ComfyUI
PyTorch
Pillow
NumPy
Requests
transformers
torchvision
realesrgan
scipy

支持

仓库地址：fchangjun/Baidu_Meux_ComfyTools
问题反馈：GitHub Issues

README.md Unescape Escape

Baidu Meux ComfyTools

English

Overview

Changelog

Installation / Update

Quick Usage

MeuxImageLoader

MeuxMaskLoader

Workflow-Compatible Mask Nodes

Other Utility Nodes

MeuxArtisticTextPreview

Folder Structure

Requirements

Support

中文

概述

更新日志

安装 / 更新

快速使用

MeuxImageLoader

MeuxMaskLoader

工作流兼容遮罩节点

其他工具节点

MeuxArtisticTextPreview

目录结构

依赖

支持

README.md