v0.1.9

Changelog

[0.1.9] - 2026-01-12

This release refactors the registry management CLI for better consistency and improves the out-of-the-box experience by automating the initial registry synchronization.

Added

• Automatic registry update during initial setup: the default registry is now synchronized immediately upon initialization so users are not left with an empty list.

Changed

• Renamed the registry command add to set.
• Updated registry set argument requirements: both name and url are now mandatory positional arguments.
• Version updated to 0.1.9.

Removed

• Removed automatic registry name deduction from URLs; users must now explicitly provide a name when configuring a registry.

v0.1.8

Changelog

[0.1.8] - 2026-01-11

This version introduces a major architectural shift from static, bundled model source files to a dynamic, registry-based system. Users can now subscribe to remote JSON registries to keep their model sources up-to-date without needing to update the package itself.

Added

• Model Registry system: Subscribe to remote JSON registries for dynamic model source updates.
• New registry subcommand with add, list, update, and delete functionality.
• Automatic initialization and caching of a default remote model source registry.
• Custom user_confirm utility for more consistent interactive prompts across the CLI.
• Explicit safety confirmations for significant actions like large downloads, file deletions, and low disk space warnings.
• Registry-based source resolution: The tool now resolves source names (e.g., flux) by checking subscribed registries.

Changed

• Refactored model source resolution logic to prioritize registries over legacy built-in YAML files.
• Updated comfydl sources to aggregate and display models from all active registries.
• Improved help text and CLI documentation in the README for better clarity on AIR URN usage and registry management.
• Standardized confirmation prompts to require explicit user interaction unless the --yes flag is used.

Removed

• Deleted all bundled YAML model source files (e.g., flux1.yaml, sdxl.yaml, controlnet_sd15.yaml, etc.) as these are now managed via the default remote registry.
• Removed legacy shell scripts from the repository and documentation.
• Removed the model_sources directory from package data in pyproject.toml.

Fixed

• Improved robustness of disk space checks and confirmation logic in both civitai and standard download flows.
• Fixed an issue where the tool would check for outdated local source directories that no longer exist.

v0.1.7

Changelog

[0.1.17] - 2026-01-11

This update introduces significant improvements to the download workflow, focusing on safety and flexibility. Users can now download models directly via URLs, benefit from automatic disk space checks, and utilize new CLI flags for automation. Two new model sources for FLUX.1-dev ControlNet have also been added.

Added

• Disk Space Management: Added a pre-download check that validates available disk space against the required file size to prevent partial downloads and disk errors.
• Direct URL Downloads: Support for downloading models by passing a raw URL directly to the main command.
• Intelligent Destination Suggestion: When downloading via URL, the tool now scans existing model sources to suggest the most appropriate folder.
• Interactive Folder Selection: Provides a list of common ComfyUI directories (checkpoints, loras, etc.) if a destination is not specified.
• Automation Flags: Added the -y / --yes flag to skip interactive confirmation prompts and the -d / --directory flag to manually specify a target path.
• Civitai Enhancements: Civitai downloads now include remote size fetching and confirmation prompts.
• New Model Sources: Added configuration files for FLUX.1-dev ControlNet Union Pro 2.0 (Standard BF16) and its FP8 Quantized version.

Changed

• Refactored the code to move utility functions like format_size and disk space checks into a centralized utility module.
• Updated the download process to calculate and display the total download size for multi-file sources.
• Standardized confirmation prompts across all download methods (Civitai, Source-based, and Direct URL).

Fixed

• Improved handling of remote file sizes by implementing a fallback fetch mechanism when metadata is missing from the API.

v0.1.6

Changelog

[0.1.6] - 2025-01-08

This version introduces significant enhancements to model management, including a new detailed status auditing system and safe model removal capabilities. Users can now view installation status with file sizes in a tree view and interactively uninstall model sources. Support for Civitai AIR URNs and several new model configurations for Flux and Qwen has also been added.

Added

• New rm command for safely removing model sources, featuring interactive menus, dry-run mode, and force removal.
• Detailed installation status and auditing via sources --installed, displaying file sizes and partial installation markers.
• Support for Civitai AIR URNs (urn:air:...@Version) in the civitai download command.
• Remote file size fetching for missing models using HTTP HEAD requests.
• Visual file tree representation for model sources with status indicators: [✓] (Installed), [ ] (Missing), and [!] (Partially installed).
• New model source configurations: Flux.1 Dev GGUF (Q4_1), Qwen Image Edit 2509 (FP8 and GGUF Q6 versions), and Qwen Image InstantX ControlNets.

Changed

• Improved Civitai ID extraction to support modelVersionId query parameters in URLs.
• Enhanced process_download to display a status tree and confirm file existence before initiating downloads.
• Refactored list and sources commands to use the improved tree-view formatting.
• Updated README documentation with a streamlined configuration table and expanded usage examples.
• Optimized download logic to automatically skip files that are already present on disk.

Removed

• Removed specific redundant entries from the Qwen Image ControlNet configuration.

Fixed

• Fixed issues where partially downloaded or existing files were not correctly identified before starting a new download process.

v0.1.5

Changelog

[0.1.5] - 2026-01-08

This update introduces enhanced model management capabilities, including the ability to track installation status and safely remove models through a new command-line interface.

Added

• Added rm command to remove models associated with specific model sources from the ComfyUI directory.
• Added interactive selection for the rm command using checkboxes when no specific sources are provided.
• Added --dry-run flag to the rm command to preview deletions without removing files.
• Added --force flag to the rm command to skip deletion confirmation prompts.
• Added --installed flag to the sources command to display the installation status and file sizes of models.
• Added a visual legend for installation status: [✓] Installed, [ ] Missing, and [!] Partially Installed.
• Added tree-view formatting for sources containing multiple files to clearly show individual file status and sizes.
• Added support for --comfyui_path override in both sources and rm commands.

Changed

• Improved the sources command output to provide detailed feedback on file paths and space usage.
• Enhanced YAML configuration parsing to handle both list and dictionary-based download definitions.
• Updated project version to 0.1.5.

Fixed

• Improved path resolution and existence checking to prevent errors when attempting to process missing directories or files.

v0.1.4

Changelog

[0.1.4] - 2026-01-08

This release introduces the ability to configure a custom directory for model sources, providing users with more flexibility in managing their YAML definitions. By setting a custom path, users can now prioritize their own model collections over global or built-in sources.

Added

• Added support for a new configuration key: MODEL_SOURCES_PATH.
• Added GEMINI.md to .gitignore.
• New logic to scan and resolve model definitions from the configured custom sources directory.

Changed

• Updated the model source resolution order: Custom Model Sources Path is now checked immediately after an exact file path and before User Global Storage.
• Updated README.md with instructions on how to set the custom sources path and an updated description of the resolution priority.
• Modified the "available sources" list to include entries found in the custom sources directory.
• Incremented project version to 0.1.4 in pyproject.toml.

v0.1.3

Changelog

[Version 0.1.3] - 2026-01-08

This release introduces a new command to list locally downloaded models within your ComfyUI installation, providing their individual sizes and a total disk usage summary. Additionally, the command for listing available model sources has been renamed for better clarity.

Added

• Implemented a new list command (comfydl list) to scan and display all downloaded models within your ComfyUI models directory.
• The list command shows the relative path and formatted size for each model and provides a total size summary of all models.
• Added a format_size utility function to display file sizes in a human-readable format (e.g., KB, MB, GB).

Changed

• The command to list available model sources has been renamed from comfydl list to comfydl sources to avoid ambiguity with the new local model listing feature.

v0.1.2

Initial release on PyPI.