Files
2025-08-09 14:23:21 -07:00

93 lines
3.8 KiB
Markdown

# Changelog
All notable changes to MetaMan will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [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.