ComfyUI Extension: ComfyUI-Lora-Manager

Authored by willmiao

Created

Updated

247 stars

LoRA Manager for ComfyUI - Access it at http://localhost:8188/loras for managing LoRA models with previews and metadata integration.

Custom Nodes (3)

README

ComfyUI LoRA Manager

Revolutionize your workflow with the ultimate LoRA companion for ComfyUI!

Discord Release Release Date

A comprehensive toolset that streamlines organizing, downloading, and applying LoRA models in ComfyUI. With powerful features like recipe management, checkpoint organization, and one-click workflow integration, working with models becomes faster, smoother, and significantly easier. Access the interface at: http://localhost:8188/loras

Interface Preview

One-click Integration: One-Click Integration

📺 Tutorial: One-Click LoRA Integration

Watch this quick tutorial to learn how to use the new one-click LoRA integration feature:

One-Click LoRA Integration Tutorial

Release Notes

v0.8.15

  • Enhanced One-Click Integration - Replaced copy button with direct send button allowing LoRAs/recipes to be sent directly to your current ComfyUI workflow without needing to paste
  • Flexible Workflow Integration - Click to append LoRAs/recipes to existing loader nodes or Shift+click to replace content, with additional right-click menu options for "Send to Workflow (Append)" or "Send to Workflow (Replace)"
  • Improved LoRA Loader Controls - Added header drag functionality for proportional strength adjustment of all LoRAs simultaneously (including CLIP strengths when expanded)
  • Keyboard Navigation Support - Implemented Page Up/Down for page scrolling, Home key to jump to top, and End key to jump to bottom for faster browsing through large collections

v0.8.14

  • Virtualized Scrolling - Completely rebuilt rendering mechanism for smooth browsing with no lag or freezing, now supporting virtually unlimited model collections with optimized layouts for large displays, improving space utilization and user experience
  • Compact Display Mode - Added space-efficient view option that displays more cards per row (7 on 1080p, 8 on 2K, 10 on 4K)
  • Enhanced LoRA Node Functionality - Comprehensive improvements to LoRA loader/stacker nodes including real-time trigger word updates (reflecting any change anywhere in the LoRA chain for precise updates) and expanded context menu with "Copy Notes" and "Copy Trigger Words" options for faster workflow

v0.8.13

  • Enhanced Recipe Management - Added "Find duplicates" feature to identify and batch delete duplicate recipes with duplicate detection notifications during imports
  • Improved Source Tracking - Source URLs are now saved with recipes imported via URL, allowing users to view original content with one click or manually edit links
  • Advanced LoRA Control - Double-click LoRAs in Loader/Stacker nodes to access expanded CLIP strength controls for more precise adjustments of model and CLIP strength separately
  • Lycoris Model Support - Added compatibility with Lycoris models for expanded creative options
  • Bug Fixes & UX Improvements - Resolved various issues and enhanced overall user experience with numerous optimizations

v0.8.12

  • Enhanced Model Discovery - Added alphabetical navigation bar to LoRAs page for faster browsing through large collections
  • Optimized Example Images - Improved download logic to automatically refresh stale metadata before fetching example images
  • Model Exclusion System - New right-click option to exclude specific LoRAs or checkpoints from management
  • Improved Showcase Experience - Enhanced interaction in LoRA and checkpoint showcase areas for better usability

v0.8.11

  • Offline Image Support - Added functionality to download and save all model example images locally, ensuring access even when offline or if images are removed from CivitAI or the site is down
  • Resilient Download System - Implemented pause/resume capability with checkpoint recovery that persists through restarts or unexpected exits
  • Bug Fixes & Stability - Resolved various issues to enhance overall reliability and performance

v0.8.10

  • Standalone Mode - Run LoRA Manager independently from ComfyUI for a lightweight experience that works even with other stable diffusion interfaces
  • Portable Edition - New one-click portable version for easy startup and updates in standalone mode
  • Enhanced Metadata Collection - Added support for SamplerCustomAdvanced node in the metadata collector module
  • Improved UI Organization - Optimized Lora Loader node height to display up to 5 LoRAs at once with scrolling capability for larger collections

v0.8.9

  • Favorites System - New functionality to bookmark your favorite LoRAs and checkpoints for quick access and better organization
  • Enhanced UI Controls - Increased model card button sizes for improved usability and easier interaction
  • Smoother Page Transitions - Optimized interface switching between pages, eliminating flash issues particularly noticeable in dark theme
  • Bug Fixes & Stability - Resolved various issues to enhance overall reliability and performance

v0.8.8

  • Real-time TriggerWord Updates - Enhanced TriggerWord Toggle node to instantly update when connected Lora Loader or Lora Stacker nodes change, without requiring workflow execution
  • Optimized Metadata Recovery - Improved utilization of existing .civitai.info files for faster initialization and preservation of metadata from models deleted from CivitAI
  • Migration Acceleration - Further speed improvements for users transitioning from A1111/Forge environments
  • Bug Fixes & Stability - Resolved various issues to enhance overall reliability and performance

v0.8.7

  • Enhanced Context Menu - Added comprehensive context menu functionality to Recipes and Checkpoints pages for improved workflow
  • Interactive LoRA Strength Control - Implemented drag functionality in LoRA Loader for intuitive strength adjustment
  • Metadata Collector Overhaul - Rebuilt metadata collection system with optimized architecture for better performance
  • Improved Save Image Node - Enhanced metadata capture and image saving performance with the new metadata collector
  • Streamlined Recipe Saving - Optimized Save Recipe functionality to work independently without requiring Preview Image nodes
  • Bug Fixes & Stability - Resolved various issues to enhance overall reliability and performance

v0.8.6 Major Update

  • Checkpoint Management - Added comprehensive management for model checkpoints including scanning, searching, filtering, and deletion
  • Enhanced Metadata Support - New capabilities for retrieving and managing checkpoint metadata with improved operations
  • Improved Initial Loading - Optimized cache initialization with visual progress indicators for better user experience

v0.8.5

  • Enhanced LoRA & Recipe Connectivity - Added Recipes tab in LoRA details to see all recipes using a specific LoRA
  • Improved Navigation - New shortcuts to jump between related LoRAs and Recipes with one-click navigation
  • Video Preview Controls - Added "Autoplay Videos on Hover" setting to optimize performance and reduce resource usage
  • UI Experience Refinements - Smoother transitions between related content pages

v0.8.4

  • Node Layout Improvements - Fixed layout issues with LoRA Loader and Trigger Words Toggle nodes in newer ComfyUI frontend versions
  • Recipe LoRA Reconnection - Added ability to reconnect deleted LoRAs in recipes by clicking the "deleted" badge in recipe details
  • Bug Fixes & Stability - Resolved various issues for improved reliability

v0.8.3

  • Enhanced Workflow Parser - Rebuilt workflow analysis engine with improved support for ComfyUI core nodes and easier extensibility
  • Improved Recipe System - Refined the experimental Save Recipe functionality with better workflow integration
  • New Save Image Node - Added experimental node with metadata support for perfect CivitAI compatibility
    • Supports dynamic filename prefixes with variables 1
  • Default LoRA Root Setting - Added configuration option for setting your preferred LoRA directory

v0.8.2

  • Faster Initialization for Forge Users - Improved first-run efficiency by utilizing existing .json and .civitai.info files from Forge’s CivitAI helper extension, making migration smoother.
  • LoRA Filename Editing - Added support for renaming LoRA files directly within LoRA Manager.
  • Recipe Editing - Users can now edit recipe names and tags.
  • Retain Deleted LoRAs in Recipes - Deleted LoRAs will remain listed in recipes, allowing future functionality to reconnect them once re-obtained.
  • Download Missing LoRAs from Recipes - Easily fetch missing LoRAs associated with a recipe.

v0.8.1

  • Base Model Correction - Added support for modifying base model associations to fix incorrect metadata for non-CivitAI LoRAs
  • LoRA Loader Flexibility - Made CLIP input optional for model-only workflows like Hunyuan video generation
  • Expanded Recipe Support - Added compatibility with 3 additional recipe metadata formats
  • Enhanced Showcase Images - Generation parameters now displayed alongside LoRA preview images
  • UI Improvements & Bug Fixes - Various interface refinements and stability enhancements

v0.8.0

  • Introduced LoRA Recipes - Create, import, save, and share your favorite LoRA combinations
  • Recipe Management System - Easily browse, search, and organize your LoRA recipes
  • Workflow Integration - Save recipes directly from your workflow with generation parameters preserved
  • Simplified Workflow Application - Quickly apply saved recipes to new projects
  • Enhanced UI & UX - Improved interface design and user experience
  • Bug Fixes & Stability - Resolved various issues and enhanced overall performance

View Update History

⚠ Important Note: To use the CivitAI download feature, you'll need to:

  1. Get your CivitAI API key from your profile settings
  2. Add it to the LoRA Manager settings page
  3. Save the settings

Key Features

  • 🚀 High Performance
    • Fast model loading and browsing
    • Smooth scrolling through large collections
    • Real-time updates when files change
  • 📂 Advanced Organization
    • Quick search with fuzzy matching
    • Folder-based categorization
    • Move LoRAs between folders
    • Sort by name or date
  • 🌐 Rich Model Integration
    • Direct download from CivitAI
    • Preview images and videos
    • Model descriptions and version selection
    • Trigger words at a glance
    • One-click workflow integration with preset values
  • 🔄 Checkpoint Management
    • Scan and organize checkpoint models
    • Filter and search your collection
    • View and edit metadata
    • Clean up and manage disk space
  • 🧩 LoRA Recipes
    • Save and share favorite LoRA combinations
    • Preserve generation parameters for future reference
    • Quick application to workflows
    • Import/export functionality for community sharing
  • 💻 User Friendly
    • One-click access from ComfyUI menu
    • Context menu for quick actions
    • Custom notes and usage tips
    • Multi-folder support
    • Visual progress indicators during initialization

Installation

Option 1: ComfyUI Manager (Recommended for ComfyUI users)

  1. Open ComfyUI.
  2. Go to Manager > Custom Node Manager.
  3. Search for lora-manager.
  4. Click Install.

Option 2: Portable Standalone Edition (No ComfyUI required)

  1. Download the Portable Package
  2. Copy the provided settings.json.example file to create a new file named settings.json in comfyui-lora-manager folder
  3. Edit settings.json to include your correct model folder paths and CivitAI API key
  4. Run run.bat

Option 3: Manual Installation

git clone https://github.com/willmiao/ComfyUI-Lora-Manager.git
cd ComfyUI-Lora-Manager
pip install -r requirements.txt

Usage

  1. There are two ways to access the LoRA manager:
    • Click the "Launch LoRA Manager" button in the ComfyUI menu
    • Visit http://localhost:8188/loras directly
  2. From the interface, you can:
    • Browse and organize your LoRA models
    • Download models directly from CivitAI
    • Automatically fetch or manually set preview images
    • View and copy trigger words associated with each LoRA
    • Add personal notes and usage tips
  3. To use LoRAs in your workflow:
    • Add the "Lora Loader (LoraManager)" node to your workflow
    • Select a LoRA in the manager interface
    • Click copy button or use right-click menu "Copy LoRA syntax"
    • Paste into the Lora Loader node's text input
    • The node will automatically apply preset strength and trigger words

Filename Format Patterns for Save Image Node

The Save Image Node supports dynamic filename generation using pattern codes. You can customize how your images are named using the following format patterns:

Available Pattern Codes

  • %seed% - Inserts the generation seed number
  • %width% - Inserts the image width
  • %height% - Inserts the image height
  • %pprompt:N% - Inserts the positive prompt (limited to N characters)
  • %nprompt:N% - Inserts the negative prompt (limited to N characters)
  • %model:N% - Inserts the model/checkpoint name (limited to N characters)
  • %date% - Inserts current date/time as "yyyyMMddhhmmss"
  • %date:FORMAT% - Inserts date using custom format with:
    • yyyy - 4-digit year
    • yy - 2-digit year
    • MM - 2-digit month
    • dd - 2-digit day
    • hh - 2-digit hour
    • mm - 2-digit minute
    • ss - 2-digit second

Examples

  • image_%seed% → image_1234567890
  • gen_%width%x%height% → gen_512x768
  • %model:10%_%seed% → dreamshape_1234567890
  • %date:yyyy-MM-dd% → 2025-04-28
  • %pprompt:20%_%seed% → beautiful landscape_1234567890
  • %model%_%date:yyMMdd%_%seed% → dreamshaper_v8_250428_1234567890

You can combine multiple patterns to create detailed, organized filenames for your generated images.

Standalone Mode

You can now run LoRA Manager independently from ComfyUI:

  1. For ComfyUI users:

    • Launch ComfyUI with LoRA Manager at least once to initialize the necessary path information in the settings.json file.
    • Make sure dependencies are installed: pip install -r requirements.txt
    • From your ComfyUI root directory, run: 
      python custom_nodes\comfyui-lora-manager\standalone.py
    • Access the interface at: http://localhost:8188/loras
    • You can specify a different host or port with arguments: 
      python custom_nodes\comfyui-lora-manager\standalone.py --host 127.0.0.1 --port 9000

  2. For non-ComfyUI users:

    • Copy the provided settings.json.example file to create a new file named settings.json
    • Edit settings.json to include your correct model folder paths and CivitAI API key
    • Install required dependencies: pip install -r requirements.txt
    • Run standalone mode: 
      python standalone.py
    • Access the interface through your browser at: http://localhost:8188/loras

This standalone mode provides a lightweight option for managing your model and recipe collection without needing to run the full ComfyUI environment, making it useful even for users who primarily use other stable diffusion interfaces.

Contributing

Thank you for your interest in contributing to ComfyUI LoRA Manager! As this project is currently in its early stages and undergoing rapid development and refactoring, we are temporarily not accepting pull requests.

However, your feedback and ideas are extremely valuable to us:

  • Please feel free to open issues for any bugs you encounter
  • Submit feature requests through GitHub issues
  • Share your suggestions for improvements

We appreciate your understanding and look forward to potentially accepting code contributions once the project architecture stabilizes.

Credits

This project has been inspired by and benefited from other excellent ComfyUI extensions:

☕ Support

If you find this project helpful, consider supporting its development:

ko-fi

WeChat: Click to view QR code

💬 Community

Join our Discord community for support, discussions, and updates: Discord Server