Civitai Toolkit

👉 点击这里查看中文文档

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.
Civitai Browser Civitai Browser Pop

🗂️ 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.
Local Manager Local Manager Pop

🧩 Core Node Suite

1️⃣ Visual Recipe Finder

  • 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.

🕒 Changelog

[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.

🙏 Credits

Heartfelt thanks to all the amazing open-source projects and their authors 🙌

S
Description
No description provided
Readme MIT
4.9 MiB
Languages
Python 53.6%
JavaScript 46.4%