Changelog

All notable changes to MetaMan will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0] - 2025-08-08

Added

Universal Metadata Management System
- Custom "meta" PNG chunk standard for cross-platform compatibility
- Universal schema supporting 60+ metadata fields across all major platforms
- Template-driven architecture for easy platform extension
Cross-Platform Workflow Generation
- Simplified Workflow Generation: Convert ANY platform's metadata into working ComfyUI workflows that recreate identical images
- Complex Workflow Preservation: Full-fidelity preservation of ComfyUI node graphs and custom arrangements
- Bidirectional conversion between all supported platforms
- Perfect image reproduction across platform boundaries
Platform Support
- Automatic1111 (A1111) - Full parameter format support with ComfyUI workflow generation
- ComfyUI - Complete workflow and prompt preservation
- Civitai - Enhanced resource tracking with model IDs and workflow generation
- Forge - A1111-compatible with advanced sampling extensions
- Tensor.AI - JSON-based metadata format with workflow generation
- Leonardo.AI - Style and preset management system with workflow generation
ComfyUI Nodes
- MetaMan Universal - Primary metadata extraction and conversion
- MetaMan Workflow Saver - Dedicated workflow preservation with multiple output formats
- MetaMan Dependency Resolver - Model dependency tracking with download URLs
Core Features
- Intelligent service detection with confidence scoring
- Bidirectional metadata conversion between platforms
- Model dependency resolution via Civitai and HuggingFace APIs
- Comprehensive validation and testing system
- PNG metadata embedding with compression support
- Rate-limited API integration respecting platform limits
Template System
- YAML-based service templates for easy extension
- Universal metadata schema with field compatibility tracking
- Service-specific output formatters with validation rules
- Automatic field mapping and type conversion
Documentation
- Comprehensive README with usage examples
- Detailed setup and configuration guide (SETUP.md)
- Contributing guidelines for community development
- Installation test script and validation system

Technical Details

Python 3.8+ support with modern type hints
Pillow integration for robust PNG metadata handling
SHA256 hash-based model identification for accuracy
Extensible architecture supporting future platforms
Memory-efficient processing with lazy loading
Cross-platform compatibility (Windows, macOS, Linux)

Dependencies

Pillow >= 9.0.0 (image processing)
PyYAML >= 6.0.0 (template processing)
piexif >= 1.1.3 (EXIF metadata handling)
requests >= 2.28.0 (API integration)
jsonschema >= 4.17.0 (validation)
torch (provided by ComfyUI environment)

[Unreleased]

Planned Features

SeaArt.AI template support
Midjourney metadata extraction (where available)
Batch processing optimization
Advanced workflow analysis tools
Model hash verification utilities
Plugin system for custom extractors
GUI configuration interface
Automatic model downloading integration
Workflow sharing and marketplace integration

Version History Notes

Major versions (X.0.0): Breaking changes, new architecture, major platform additions
Minor versions (0.X.0): New platforms, significant features, template additions
Patch versions (0.0.X): Bug fixes, template updates, documentation improvements

For upgrade instructions between major versions, see SETUP.md.

3.8 KiB Raw Permalink Blame History