Skip to content
Node packVerifiedExternal
Open source

AAA_Metadata_System

Comprehensive metadata management for ComfyUI - multi-format support, smart merging, database storage, and workflow preservation. Load and save .psd, .tiff, .svg with layers, and other tools.

Maintainer@EricRolleiUnratedgrade

Package profile

Status
Verified
Publisher
@EricRollei
Source
GitHub

README

AAA Metadata System for ComfyUI

GitHub License Python

Advanced metadata management and multi-format image save/load system for ComfyUI with professional features for Adobe workflows and color management.

🎯 Key Highlights

🎨 Professional Format Support

  • Adobe Photoshop PSD - Load and save with full layer preservation, blend modes, and layer groups
  • True Vector SVG - Native SVG export with embedded metadata and scalability
  • ICC Color Profile Management - Embed and preserve color profiles (sRGB, Adobe RGB, ProPhoto RGB, etc.)
  • Adobe-Compatible Metadata - XMP sidecar files formatted for Photoshop, Lightroom, Bridge, and other cataloging software
  • MWG-RS Compliant Regions - Face/area metadata with coordinates compatible with Adobe's region standard

📁 Multi-Format Image Support

  • PNG - Full metadata embedding with workflow preservation
  • JPEG - Smart 4-stage fallback for EXIF size limits
  • TIFF - 16-bit support with layers and metadata
  • WebP - Modern format with full metadata
  • PSD - Complete Photoshop file support with layers, blend modes, and groups

📋 Comprehensive Metadata Management

  • XMP Sidecar Files - Industry-standard structured metadata for Adobe applications
  • TXT Summaries - Human-readable metadata descriptions
  • JSON Export - Complete metadata for custom workflows
  • Embedded EXIF/XMP - In-image metadata for portability
  • SQLite Database - Optional centralized metadata storage

Overview

This metadata system provides professional-grade image and metadata management for ComfyUI workflows, with deep integration for Adobe software ecosystems and color-managed workflows.

🌟 Features

  • Multi-format Support: Store metadata in multiple locations simultaneously for maximum compatibility with various software and workflows
  • Smart Merging: Intelligently merge metadata from different sources with conflict resolution and prioritization
  • Extensible Structure: Well-organized metadata structure with sections for different types of information, easily extended with custom fields
  • ComfyUI Integration: Seamlessly integrates with ComfyUI nodes for workflow capture and parameter extraction
  • Human-readable Output: Optional human-readable text format with context-aware descriptions for easy viewing
  • MWG Standard Compliance: Follows Metadata Working Group standards for compatibility with professional software
  • Workflow Data Preservation: Captures generation parameters and workflow structure for reproducibility
  • Advanced Querying: Complex metadata filtering and searching with multiple query methods
  • Error Recovery: Sophisticated error handling and recovery strategies to prevent data loss
  • Thread Safety: Lock-based concurrency protection for multi-threaded applications

Installation

📋 Requirements

  • Python 3.8+
  • ComfyUI
  • PyExiv2 (optional, for enhanced embedded metadata support)
  • ExifTool (optional, for additional format support)

🚀 Install as ComfyUI Custom Node

Option 1: Clone Repository

  1. Clone this repository into your ComfyUI custom_nodes directory:
cd ComfyUI/custom_nodes
git clone https://github.com/EricRollei/AAA_Metadata_System.git
  1. Install required dependencies:
cd AAA_Metadata_System
pip install -r requirements.txt
  1. Restart ComfyUI

For detailed installation instructions, including platform-specific steps for PyExiv2 and ExifTool, see INSTALLATION.md.

Included Nodes

This package includes several ComfyUI nodes that integrate with the metadata system:

Metadata Save Image Node

Metadata Save Image Node

This node saves images with comprehensive metadata embedding. It extends ComfyUI's standard image saving capabilities with:

  • Multiple Format Support: Save

Nodes in this pack

56 nodes
  • AspectRatio2StepLatent
  • CheckpointBatchInfoSetter_v074
  • CheckpointInfoSetter_v074
  • CheckpointInfoViewer_v074
  • CheckpointParamsLoader_v074
  • CheckpointTester_v074
  • ColorNameToRGB_v01
  • ColorSelector
  • CulturalColorPaletteGenerator_v01
  • EnhancedMetadataFilterNode_V2
  • Eric_Color_Palette_Analyzer_v3
  • Eric_Duplicate_Image_Finder_v04
  • Eric_Metadata_Debugger_V2
  • Eric_Metadata_Entry_V2
  • Eric_Metadata_Filter_V2
  • Eric_Metadata_Query_V3
  • Eric_Workflow_Toolkit_v2
  • EricCivitaiPromptExtractor
  • EricCivitaiPromptExtractorAutoLoader
  • EricLoadImageExtended
  • EricLoadImageWithLayers
  • EricSaveTrueSVGImage
  • EricsWordCloudNode
  • FileOrganizer
  • FlattenNestedFiles_v2
  • LoRABatchInfoSetter_v03
  • LoRABulkOperations_v03
  • LoRADatabaseMaintenance_v03
  • LoRADatabaseStats_v03
  • LoRAGalleryDisplay_v03
  • LoRAGalleryWithEdit_v03
  • LoRAInfoSetter_v03
  • LoRAInfoViewer_v03
  • LoRAParamsLoader_v03
  • LoRAQuickFeedback_v03
  • LoRATester_v03
  • MetadataAwareSaveImage_Simple
  • MetadataAwareSaveImage_v099d
  • MetadataConsolidatorNode_V2
  • Multi-LoRA Loader [PLATFORM_NAME]
  • Multi-LoRA Loader Flux
  • Multi-LoRA Loader Model-Only
  • Multi-LoRA Loader Qwen
  • Multi-LoRA Loader v02
  • Multi-LoRA Loader Wan-i2v
  • Multi-LoRA Loader Wan-t2v
  • Multi-LoRA Loader Z-Image
  • MyCustomNode
  • PngInfoDiagnosticV3
  • PngMetadataExtractorV3
  • SmartImageCropper
  • SplitWorkflowExtractorNode_V2
  • TextOverlayNode_v04
  • TriggerWordManager_v03
  • Wan22_Size_Preset
  • Wan22AspectRatioHelper

Sources

3 sources
GitHubSourceVersion d708917b50e85dd43ae620848d6618c67e410371
github.com/EricRollei/AAA_Metadata_System

Verified Oct 12

Source excerpts

1 excerpt

Source context: Repo EricRollei/AAA_Metadata_System