AAA Metadata System v0.1.0 - Initial Release

🎉 Initial Release

Comprehensive metadata management and multi-format image save system for ComfyUI.

✨ Major Features

Multi-Format Support

• PNG - Full metadata embedding with workflow support
• JPEG - 4-stage fallback system for EXIF size limits
• TIFF - High bit-depth with metadata preservation
• PSD - Layer-aware save/load with full metadata
• SVG - Vector format with metadata annotations
• WebP - Modern format with metadata support

Metadata Systems

• XMP Sidecar Files - Structured metadata in .xmp format
• TXT Sidecar Files - Human-readable summaries
• JSON Sidecar Files - Complete metadata export
• Embedded EXIF/XMP - In-image metadata for compatibility
• MWG-RS Compliant XMP Regions - Face/area metadata with coordinates and extensions

Runtime Execution Hooks

• Capture actual node execution data for accurate metadata
• Per-node configuration with dropdown controls (Auto/Enabled/Disabled)
• Performance tracking and disagreement logging
• Configurable inline size limits
• Priority system: per-node > config.json > defaults

Workflow Intelligence

• Automatic workflow parsing and node traversal
• LoRA detection (loader nodes and inline tags)
• Embedding detection and tracking
• Sampler discovery with BFS prioritization
• Prompt extraction with distance ranking

Compatibility

• Automatic1111 parameter string generation
• Photoshop XMP region compatibility
• Adobe Bridge metadata standards
• Backward compatible with existing workflows

📦 Core Nodes

Save Image Nodes

• MetadataAwareSaveImage - Advanced save with all features
• MetadataAwareSaveImage (Simple) - Streamlined version

LoRA Loaders

• Multi_LoRA_Loader_v02 - Load up to 8 LoRAs with individual controls
• Multi_LoRA_Loader_Base - Base model variant
• Multi_LoRA_Loader_Model_Only - Model-only variant

PSD Support

• LoadImageLayers - Load PSD files with layer selection
• Layer preservation on save
• Alpha channel handling

⚙️ Configuration

config.json

{
  "runtime_hooks": {
    "enabled": false,
    "log_disagreements": false,
    "log_performance": false,
    "inline_size_limit_kb": 32
  },
  "debug": {
    "enabled": false
  },
  "metadata": {
    "enable_hash_cache": true
  }
}

Per-Node Controls

• enable_runtime_hooks dropdown in save nodes
  • "Auto (use config)" - Defer to config.json
  • "Enabled" - Force ON for this workflow
  • "Disabled" - Force OFF for this workflow

🧪 Test Coverage

143 tests passing across multiple categories:

• ✅ 7 backward compatibility tests - Old workflow migration
• ✅ 6 XMP region tests - MWG-RS round-trip validation
• ✅ 9 per-node toggle tests - Configuration priority
• ✅ 17 runtime hooks enhancement tests - Performance and logging
• ✅ 104 existing tests - File formats, metadata, workflow parsing

📚 Documentation

User Guides

• CONFIG_GUIDE.md - Complete configuration reference
• RUNTIME_HOOKS_QUICK_REFERENCE.md - Quick setup guide
• README.md - Project overview and quick start

Technical Documentation

• RUNTIME_HOOKS_ENHANCEMENTS_SUMMARY.md - Enhancement details
• SAFE_RUNTIME_HOOKS_RESEARCH.md - Safety analysis
• edit_log.md - Complete development history

🚀 Installation

Via ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for "AAA Metadata System"
3. Click Install
4. Restart ComfyUI

Manual Installation

cd ComfyUI/custom_nodes
git clone https://github.com/EricRollei/AAA_Metadata_System.git
cd AAA_Metadata_System
pip install -r requirements.txt

Required: piexif
Optional: psd-tools (for PSD support), pillow (usually included)

🔧 Quick Start

1. Add a save node to your workflow

   • Find "MetadataAwareSaveImage" in node menu
   • Configure output format and metadata options

2. Enable metadata targets

   • XMP sidecar: Structured metadata for Adobe apps
   • TXT sidecar: Human-readable summary
   • Embedded: In-image metadata (PNG/JPEG/TIFF)

3. Optional: Enable runtime hooks

   • Edit config.json or use per-node dropdown
   • Captures actual execution data for accurate metadata

4. Save and review

   • Images saved with metadata in all selected formats
   • Sidecar files created automatically

🐛 Known Issues

• None reported at initial release

🙏 Credits

Developed by Eric Hiss aka EricRollei
Built for the ComfyUI community

📝 License

See LICENSE file in repository

🔗 Links

• Repository: https://github.com/EricRollei/AAA_Metadata_System
• Issues: https://github.com/EricRollei/AAA_Metadata_System/issues
• Discussions: https://github.com/EricRollei/AAA_Metadata_System/discussions