ComfyUI Extension: Civitai Toolkit

Authored by BAIKEMARK

Created

Updated

68 stars

All-in-one Civitai integration center for ComfyUI β€” browse online models, manage local assets,analyze community trends, and instantly apply full recipes within your workflow.

Custom Nodes (0)

    README

    Civitai Toolkit

    πŸ‘‰ η‚Ήε‡»θΏ™ι‡ŒζŸ₯ηœ‹δΈ­ζ–‡ζ–‡ζ‘£

    <details> <summary>πŸ•’ <b>Changelog (click to expand)</b></summary>

    [4.1.0] - 2025-10-10

    Summary: Enhance model management by adding support for multiple model types and improving API interactions. This version significantly broadens the toolkit's capabilities, allowing users to manage a wider array of local models and more reliably parse complex recipe metadata, while also fixing key network bugs.

    πŸš€ Added

    Expanded Model Type Support:

    • The Local Manager sidebar and the Recipe Gallery node now support a much wider range of model types.
    • You can now manage, filter, and select from: checkpoints, loras, vae, embeddings, diffusion_models, text_encoders, and hypernetworks.

    ✨ Improvements

    Advanced Metadata Parsing:

    • The parsing engine has been significantly upgraded to understand newer, complex metadata formats (especially from ComfyUI workflows).
    • The system is now far more robust at identifying all components of a recipe, including Checkpoints, LoRAs, and VAEs that were previously missed.

    Smarter Diagnostics:

    • The Recipe Gallery's diagnostic report now provides a direct, clickable link to the Civitai page for any Checkpoint that is specified in a recipe but is not found locally, mirroring the popular feature for missing LoRAs.

    🐞 Fixes

    • China Mirror Endpoint: Fixed a bug where selecting the "China Mirror" network in the settings did not correctly apply the endpoint for all API requests. All browser and API-related features will now correctly use the selected network.

    [4.0.2] - 2025-10-07

    Summary:
    Adds API Key support to improve reliability, authentication, and request limits for all Civitai API interactions.

    πŸš€ Added

    πŸ”‘ API Key Management

    • Introduced a brand-new β€œAPI Key Management” section in the ComfyUI Settings Panel.
    • Users can now generate an API Key from their Civitai Account Page and enter it directly in the plugin settings.
    • Once saved, all plugin requests to Civitai will automatically include Authorization headers for authentication.

    πŸ’‘ Why this matters:
    This feature helps users increase API rate limits and prepare for upcoming Civitai features that may require authentication.
    You can create and manage your API Key on the Civitai Account Settings page.

    [4.0.1] - 2025-10-06

    Fixes

    • Startup freeze issue:
      Some users reported that ComfyUI would hang indefinitely on startup when having a large number of LoRA models.
      This update fixes the issue by moving the scanning process to the background.

    Improvements

    • Background processing:
      Model hashing and Civitai info fetching now run asynchronously in the background, allowing ComfyUI to start instantly.
    • Resume support:
      Added progress persistence, resuming from the last saved state instead of starting over.

    [4.0.0] - 2025-10-05

    πŸ’₯ Major Updates

    • Officially renamed to Civitai Toolkit to reflect its all-in-one suite positioning.
    • The original Recipe Finder remains as a core module.

    ✨ New & Improved

    • Dual Sidebar UI: introduces Local Model Manager and Civitai Online Browser.
    • Enhanced UX: smoother interaction and higher model management efficiency.
    </details>

    Overview

    Civitai Toolkit is an all-in-one Civitai integration hub built exclusively for ComfyUI. It seamlessly combines online browsing and discovery, local model management, and recipe reconstruction & data analysis β€” enabling you to go from inspiration to realization without ever leaving ComfyUI.

    No more switching between your browser and file manager β€” with two powerful sidebar panels and a suite of analysis nodes, you’ll enjoy a complete Civitai experience directly inside ComfyUI.

    ✨ Key Features

    • 🌍 Civitai Online Browser Access Civitai directly within ComfyUI. Search, filter, and download models in one click.

    • πŸ—‚οΈ Local Model Manager Browse, search, and categorize local models with automatic Civitai metadata linking.

    • πŸ” Visual Recipe Finder Instantly explore a model’s popular works and restore full generation recipes (prompts, params, LoRA combos, etc.).

    • πŸ“Š Community Trend Analysis Automatically collect common generation parameters and discover popular sampler, CFG, and prompt combinations.

    • πŸ”— Golden Combination Discovery Reveal high-frequency co-usage between models and discover new creative synergies.

    • ⚑ Instant Trigger Word Extraction Extract trigger words from both local metadata and Civitai API, then generate a clean Markdown comparison table.

    🧭 Core Interfaces: Sidebar System

    🌍 Civitai Online Browser

    Highlights:

    • πŸ”Ž Advanced Search & Filtering β€” by keywords, model type, base model, sorting (Hot / New / Top Rated), etc.
    • πŸ”„ Local Sync β€” automatically marks models as β€œDownloaded” to prevent duplicates.
    • πŸ–ΌοΈ Immersive Detail View β€” model descriptions, version selector, sample gallery, file list, and direct download links.
    <div align="center" style="display: flex; flex-wrap: wrap; justify-content: center;"> <img src="./image/Civitai_Browser.png" alt="Civitai Browser" width="48%" /> <img src="./image/Civitai_Browser_pop.png" alt="Civitai Browser Pop" width="48%" /> </div>

    πŸ—‚οΈ Local Model Manager

    Highlights:

    • πŸ” Auto Scan & Recognition β€” indexes local models and matches them to Civitai database via Hash.
    • πŸ’¬ Rich Info Display β€” view version details, trigger words, ratings, downloads, and more.
    • ⚑ Streamlined Interaction β€” filter by type, keyword search, and one-click copy for Hash or triggers.
    <div align="center" style="display: flex; flex-wrap: wrap; justify-content: center;"> <img src="./image/Local_Manager.png" alt="Local Manager" width="48%" /> <img src="./image/Local_Manager_pop.png" alt="Local Manager Pop" width="48%" /> </div>

    🧩 Core Node Suite

    1️⃣ Visual Recipe Finder

    Civitai Recipe Gallery

    • Browse top-rated works for a given model and load full recipes in one click.
    • πŸš€ Instant Workflow Restore β€” safely and smartly reconstructs original workflows (ComfyUI-Manager compatible).
    • πŸ’Ύ Save Source Files β€” download images with embedded metadata to the output directory.

    | Output Port | Type | Description | | --------------- | --------------- | ------------------------------------------------------------ | | image | IMAGE | Selected sample image | | info_md | STRING | Markdown recipe report (recommended for MarkdownPresenter) | | recipe_params | RECIPE_PARAMS | Parameter pipeline (use with Get Parameters from Recipe) |

    ⚠️ First Run Notice: The first run computes model hashes (may take some time). Results are cached in Civitai Toolkit/data or Civitai_Recipe_Finder/data for faster future runs.

    gallery example

    Get Parameters from Recipe

    Unpack the recipe_params pipeline and output generation-ready parameters for KSampler: ckpt_name, positive_prompt, negative_prompt, seed, steps, cfg, sampler_name, scheduler, width, height, denoise.

    2️⃣ In-Depth Model Analysis

    Node: Model Analyzer (Checkpoint / LoRA)

    Features:

    • Unified process from data fetching β†’ community statistics β†’ parameter summary β†’ Markdown report.
    • Replaces legacy multi-node setups with faster, cleaner analysis.

    Inputs: model_name, image_limit, sort, nsfw_level, filter_type, summary_top_n, force_refresh Outputs:

    • full_report_md: Full Markdown report
    • fetch_summary: Fetch summary (e.g., β€œAnalyzed 100 entries successfully”)
    • params_pipe: Extracted community parameter pipeline (use with Get Parameters from Analysis)

    Model_DeepResearch example

    Get Parameters from Analysis

    Unpack the params_pipe to extract community-common parameters β€” works the same as Get Parameters from Recipe.

    3️⃣ Lightweight Tools

    Lora Trigger Words

    Instantly extract LoRA trigger words:

    | Output Port | Type | Content | | ------------------- | -------- | ---------------------------------- | | metadata_triggers | STRING | Local metadata trigger words | | civitai_triggers | STRING | Official Civitai API trigger words | | triggers_md | STRING | Markdown comparison table |

    lora_trigger_words example

    βš™οΈ Installation & Usage

    βœ… Manual Installation

    ComfyUI/custom_nodes/ComfyUI-Civitai-Toolkit/
pip install -r requirements.txt

    βœ… Install via ComfyUI Manager

    Search Civitai Toolkit in ComfyUI Manager β†’ click β€œInstall” β†’ restart ComfyUI. You’ll find the toolkit in the sidebar and under the Civitai node category.

    πŸ’‘ Tip: The Markdown Presenter node can be found under the Display category.

    πŸ§ͺ Workflow Examples

    • Built-in Template: Templates β†’ Custom Nodes β†’ ComfyUI-Civitai-Recipe
    • Repository Samples: example_workflows

    πŸ”§ Version Compatibility

    • Migration from ≀3.1: Go to Settings β†’ CivitaiUtils β†’ Migration to transfer old JSON cache into the new database.

    πŸ™ Credits

    Heartfelt thanks to all the amazing open-source projects and their authors πŸ™Œ