comfyui_image_metadata_extension

comfyui_image_metadata_extension
★ 84

图像元数据Civitai 兼容Lora 支持ComfyUI 插件
为 ComfyUI 保存的图像添加兼容 Civitai 的额外元数据,自动将 Lora 字符串及权重写入提示区,确保网站能识别并记录模型与权重信息。
💡 保存生成图像时自动嵌入 Lora/模型权重与其他元数据,便于上传至 Civitai。
🍴 21 Forks💻 Python🔄 2025-11-05
📦
网盘下载
复制链接后前往夸克网盘下载
https://pan.quark.cn/s/e98a62d17551
node-preview
workflow-preview
website-preview
📄 README

ComfyUI Image Metadata Extension

Custom node for ComfyUI. It adds additional metadata for saved images, ensuring compatibility with the Civitai website.

*This is a fork of nkchocoai/ComfyUI-SaveImageWithMetaData.*

Key differences:

  • Simplified the node by removing unnecessary fields for general use.
  • Included metadata for LoRa weights.
  • The subdirectory_name field allows you to specify a custom name or use mask values to create a subdirectory for saved images. For example, using the mask %date:yyyy-MM% (formatting options) will create a directory named with the current year and month (e.g., 2024-10), organizing your images by the date they were generated.
  • The output_format defines the saved image format:
  • png, jpg, webp – saves in the specified format.
  • png_with_json, jpg_with_json, webp_with_json – saves in the chosen format and writes workflow metadata to a JSON file with the same name.
  • The quality option has the following levels:
  • max / lossless WebP – 100%
  • high – 80%
  • medium – 60%
  • low – 30%
  • *(Lower quality, smaller file size. PNG images ignore this setting.)*

  • The metadata_scope option controls metadata inclusion:
  • full – default metadata with additional metadata.
  • default – same as the SaveImage node.
  • parameters_only – only A1111-style metadata.
  • workflow_only – workflow metadata only.
  • none – no metadata.
  • Installation

    Recommended Installation

    Use the ComfyUI-Manager to install.

    comfyui_image_metadata_extension

    Manual Installation

  • Navigate to the custom_nodes directory inside your ComfyUI folder.
  • Clone this repository:
  • “`bash

    git clone https://github.com/edelvarden/comfyui_image_metadata_extension.git

    “`

    Usage

    Basic usage looks like (workflow.json):

    Lora strings are automatically added to the prompt area, allowing the Civitai website to understand the weights you used. Other metadata is also successfully included.

    Formatting Options

  • The filename_prefix and subdirectory_name support the following options:
  • | Key | Information to be Replaced |

    | ————— | ————————————- |

    | %seed% | Seed value |

    | %width% | Image width |

    | %height% | Image height |

    | %pprompt% | Positive prompt |

    | %pprompt:[n]% | First n characters of positive prompt |

    | %nprompt% | Negative prompt |

    | %nprompt:[n]% | First n characters of negative prompt |

    | %model% | Checkpoint name |

    | %model:[n]% | First n characters of checkpoint name |

    | %date% | Date of generation (yyyyMMddhhmmss) |

    | %date:[format]% | Date of generation |

  • See the following table for the identifiers specified by [format] in %date:[format]%:
  • | Identifier | Description |

    | ———- | ————————— |

    | yyyy | Year |

    | MM | Month |

    | dd | Day |

    | hh | Hour |

    | mm | Minute |

    | ss | Second |

    Supported Nodes and Extensions

  • Comfy Core Nodes:
  • modules/defs/samplers.py
  • modules/defs/captures.py
  • Third-Party Nodes:
  • modules/defs/ext/
  • [!TIP]

    If you encounter errors with the “full” metadata scope, it may be because your third-party nodes are not supported. In that case, you can either use alternative nodes from Comfy Core or create a custom extension in the ext folder.