v1.3.0 CivitAI ComfyUI model manager

CivitAI Model Manager v1.3.0 🚀

I am excited to announce v1.3.0, introducing full Hugging Face Hub integration, a powerful Command Line Interface (CLI), Webhook Automations, Workflow Model Dependency Scanning, and Dual-Source Mirror Switching.

---

🌟 What's New

🤖 Hugging Face Hub Integration

• Model Repository Inspector: Live validation of Hugging Face model repositories, pipeline tags, private/gated access statuses, and file tree exploration (.safetensors / .gguf).
• Gated Model Access: Support for Hugging Face User Access Tokens (hf_...) in Settings to download and verify gated models (FLUX.1, SD3, Llama).
• Hugging Face Cache Resolver: Intelligent translation of local Hugging Face cache directories (models--<org>--<repo>) into human-readable model titles.
• hf CLI Compatibility: Native integration with the official Hugging Face CLI for hf download command generation and auth status verification.

💻 Built-in Command Line Interface (CLI)

Manage your ComfyUI models headlessly via terminal, scripts, or automated workflows:

• cmm scan [--path <dir>]: Hardware-accelerated local library directory scanning with SHA256 checksums.
• cmm download --id <id> [--version <id>]: Command-line model downloads with auto-routing and integrity verification.
• cmm check-updates: Headless batch checking of installed models for new CivitAI versions.
• cmm export [--format json|zip]: Database and configuration backups via CLI.
• cmm hf check <repo_id>: Query Hugging Face Hub metadata directly from the console.
• cmm workflows [--path <dir>]: Scan ComfyUI workflow files and identify missing model dependencies.

🔔 Webhook Event Integrations

• on_download_complete: Dispatches webhook payloads with model metadata, destination paths, and hashes upon download completion.
• on_update_available: Alerts external endpoints when newer model versions are detected on CivitAI.
• Settings UI: Test triggers and endpoint configuration with instant status feedback.

🔍 ComfyUI Workflow Scanner

• Prompt & Workflow Inspection: Recursively parses .json workflow files and embedded PNG metadata (tEXt / iTXt chunks).
• Missing Model Detection: Automatically identifies Checkpoint, LoRA, VAE, ControlNet, UNET, CLIP, and Upscaler loader nodes, flagging missing models vs. installed ones in your SQLite database.

🪞 Dual-Source CivitAI & CivitAI Red Mirrors

• Quick-toggle preset buttons for CivitAI Official (https://civitai.com/api/v1) and CivitAI Red (https://civitai.red/api/v1) directly in Settings.

---

🛠️ Developer & Platform Improvements

• Version Synchronizer Tooling: Added scripts/update-version.js, update-version.ps1, and src/version.ts for automated multi-file version updates.
• Automated Test Coverage: Added comprehensive test suites for WebhookService, WorkflowScanner, HuggingFaceClient, and the CLI Runner (15/15 passing tests).
• Electron & Web Native Bridge: Mirror IPC APIs across both desktop and browser headless modes.

---

📦 Downloads & Artifacts

File	Platform	Description
CivitAI Model Manager Setup 1.3.0.exe	Windows (x64)	Full Installer Setup (Start Menu & Desktop shortcuts)
CivitAI Model Manager-Standalone-v1.3.0.exe	Windows (x64)	Standalone Portable executable (No installation required)
civitai-model-manager-1.3.0.tar.gz	Linux (x64)	Compressed Linux binary release
civitai-model-manager-1.3.0.zip	Universal	Portable cross-platform package

---

Full Changelog: 1.2.0...v1.3.0

v1.2.0 CivitAI ComfyUI model manager

🚀 CivitAI Model Manager (ComfyUI Edition) — v1.2.0

Version 1.2.0 introduces powerful new library content controls, enhanced privacy blurring, automated 48-model pagination auto-filling, streamlined duplicate management, dynamic engine indicators, and critical security and platform dependency upgrades.

---

✨ What's New & Highlights

🛡️ Library NSFW & Content Privacy Controls

• Interactive Library N/SFW Toolbar: Added [All Content], [SFW], and [NSFW] segment filter pills in the Library header with localStorage persistence.
• Privacy Censoring Veil & Blurring:
  • Full model information (thumbnail preview, filename, model type, and file path) is blurred with a smooth privacy veil (18+ badge overlay).
  • Hovering purposefully over any blurred card smoothly reveals the content and file details.
• Per-Model Manual Tagging:
  • Every model card (including matched, unidentified, and duplicates) now features an interactive SFW / NSFW toggle button.
  • Tagged status updates immediately in SQLite, adjusting thumbnail blurring and synchronizing external links (civitai.com ↔ civitai.red).

🔍 Browse Tab Auto-Filling & Clean 48-Model Pagination

• Clean 48-Model Grid Layout: Adjusted catalog page size from 50 to 48 models (PAGE_SIZE = 48), ensuring perfect alignment across 4-column desktop grids without dangling end items.
• Multi-Batch Auto-Accumulation: When "Include Mature Content" is disabled (or constrained by your Settings slider), the browser automatically scans ahead through CivitAI API batches until 48 clean, valid models are assembled per page. No more sparse pages with only 3–6 items.
• Connected Settings Slider: The NSFW Max Visible Level (1–5) slider in Settings is now directly connected to the Browse tab catalog pipeline.
• Eliminated False NSFW Badges: Fixed issue where PG-13 / soft anime character models were misclassified with bright red NSFW badges.

🗂️ Streamlined Duplicate Model Management

• Auto-Collapse on Ignore: Clicking "Ignore Duplicate Set" automatically collapses the expanded duplicate inspector panel.
• Consolidated Master Cards: Identical files sharing the same SHA256 hash are consolidated into a single master card across all library views.
• Persistent Multi-Copy Inspector: Multi-copy sets retain a dedicated <ShieldCheck /> Multi-Copy (N) / <Copy /> Duplicate (N) button so you can inspect file paths, choose keepers, or delete redundant copies anytime.

⚡ Dynamic Engine Activity Pill

• Converted the static header badge into a reactive status pill showing live library scan percentage (Scanning Library (XX%)), active downloads count (N Downloads Active), or ComfyUI folder status (Auto-Sorter Ready / Configure Folders) with direct tab navigation on click.

---

🔒 Security & Under-the-Hood Upgrades

• Electron Single-Instance Lock: Switched from manual PID checks to Electron's native app.requestSingleInstanceLock(). Launching second instances cleanly brings the existing window to focus.
• Secure File Navigation: Replaced child_process.exec folder opening with Electron's shell.showItemInFolder() to prevent OS command injection (CWE-78).
• Core Dependencies Upgraded:
  • Upgraded Electron to v39.8.10 (security critical).
  • Upgraded electron-updater / electron-builder to patch builder-util-runtime credential leaks (GHSA-p2f4-r6v6-j797).
  • Overridden @tootallnate/once to ^2.0.1 to resolve infinite hanging promises on aborted signals (GHSA-vpq2-c234-7xj6).
  • Rebuilt native sqlite3 and keytar native bindings.

---

📦 Release Assets

• Windows (Installer): CivitAI Model Manager Setup 1.2.0.exe
• Windows (Portable): CivitAI Model Manager-Standalone-v1.2.0.exe
• Linux (Universal Archive): civitai-model-manager-1.2.0.tar.gz
• Linux (Portable ZIP): civitai-model-manager-1.2.0.zip

---

Full Changelog: v1.0.0...1.2.0

v1.0.0 CivitAI ComfyUI model manager

CivitAI Model Manager v1.0.0

Stable Release - August 2026

🎉 Initial Release

After months of development and testing, CMM 1.0.0 is ready. A desktop application for managing ComfyUI models with CivitAI integration.

---

✨ What's Included

Core Features

• CivitAI Browser - Search, filter, and download from civitai.com and civitai.red
• Local Library Scanner - Multi-folder scanning with SHA256 hash verification
• Duplicate Detection - Find identical models across your drives with inline resolution
• Auto-Organization - Downloads route to correct ComfyUI folders automatically
• Version Management - Track installed vs. latest versions, downgrade if needed

Supported Model Types (50+ folders)

Checkpoints, LoRAs, LyCORIS, DoRA, Textual Inversions, Hypernetworks, VAE, ControlNet, Upscalers, IP-Adapters, PhotoMaker, PuLID, ReActor, InsightFace, GGUF, LLM, and more.

Platform Support

• Windows - Portable .exe and NSIS installer
• macOS - .dmg package
• Linux - AppImage

Launch Modes

• Desktop App - Full Electron window with system tray
• Headless - Background server + web UI (portable, remote-friendly)
• Web Only - Browser-based interface

---

🚀 Installation

Windows Users

Download CivitAI Model Manager Setup 1.0.0.exe for standard installation, or the portable standalone if you prefer no installer.

Build from Source

git clone https://github.com/DevNullInc/Civitai-manager-ComfyUI.git
cd Civitai-manager-ComfyUI
npm install
.\cmm.ps1 start

---

⚠️ Known Issues

1. First Scan Slow - Initial library scan computes SHA256 for all files. Large libraries (1000+ models) may take 10-30 minutes depending on drive speed.

2. CivitAI Rate Limits - Unauthenticated API calls are limited. Add your API key in Settings for higher limits.

3. Windows Defender - Portable executable may trigger SmartScreen (uncommon publisher). Click "More info" → "Run anyway" if this occurs.

4. macOS Gatekeeper - May need to right-click → Open on first launch (unsigned binary).

---

📝 Breaking Changes

None - this is the initial release.

---

🔮 Roadmap

• Batch download queue with priorities
• Workflow model dependency scanner
• Automatic update notifications
• Plugin system for custom folder mappings

---

🐛 Reporting Issues

Found a bug? Report at: https://github.com/DevNullInc/Civitai-manager-ComfyUI/issues

Include:

• OS and version
• CMM version (shown in Settings → About)
• Steps to reproduce
• Error messages (if any)

---

🔐 Verification

SHA256 checksum files are included with all builds. Verify your download:

Windows:

Get-FileHash "CivitAI Model Manager Setup 1.0.0.exe" -Algorithm SHA256
# Compare with contents of CivitAI Model Manager Setup 1.0.0.exe.sha256

Linux:

sha256sum -c "CivitAI Model Manager 1.0.0.dmg.sha256"