1.4.2

v1.4.2

Release v1.4.2 - CI/CD Node 22 LTS Modernization & Tracked Test Suite

v1.4.0

Renegade Core Model Manager v1.4.0 🚀

I am annoyed yet excited to announce v1.4.0, introducing the Official ComfyUI Companion Node (1-Click Install), an interactive Visual Workflow Node Map powered by LiteGraph.js, Intelligent Model Subfolder Inspection & Health Breakdown, a Persistent SQLite-Backed Download Queue, Date-Aware Multi-Install Update Detection, dedicated macOS Launcher Scripts (cmm-mac.sh), and comprehensive Process Hardening & Security Protections.
This application was initially started just as as my own local model management software to replace stability matrix and it's missing feature set and ended up creating this abomination. I hope you all enjoy it.

---

🌟 What's New

🧩 Official ComfyUI Companion Node (1-Click Install)

• 1-Click Companion Installation: Directly clone and install the companion custom node (ComfyUI-Model-Manager) into your ComfyUI custom_nodes/ directory with automatic dependency resolution.
• Real-Time Install Status Badge: Live visual indicator in Settings showing companion node status (🟢 Installed, 🟡 Not Installed — Click to 1-Click Install, or 🟠 Directory Not Set).
• Expanded Custom Node API Aliases: Added backend endpoints (/api/download-model, /api/resolve-node, /api/search-civitai, /api/check-huggingface, /api/inspect-workflow) supporting flexible parameter casing (camelCase & snake_case).

🗺️ Visual Workflow Map with LiteGraph.js Engine

• Native LiteGraph.js Canvas: Replaced the static layout with an interactive, read-only LiteGraph.js v0.7.18 canvas identical to ComfyUI's native interface.
• Embedded Coordinate & Link Fidelity: Preserves LiteGraph spatial node positions (pos), dimensions (size), and curved bezier link connections with hover tooltips (source -> target).
• Interactive Readiness Indicators: Node boxes are color-coded in real time: 🟢 Ready (Installed), 🟡 Missing Model, and 🔴 Missing Extension.
• Smooth Navigation & Controls: 60fps cursor-anchored zoom (0.2x–2.0x), Fit to View, click-to-focus dependency cards, and a fullscreen canvas modal.

📁 Intelligent Model Subfolders & Health Diagnostics

• Non-Destructive Directory Inspection: Added FolderRouter.checkModelSubfolders verifying the disk presence of all 27 standard ComfyUI model subdirectories (checkpoints/, loras/, vae/, controlnet/, diffusion_models/, text_encoders/, unet/, gguf/, wildcards/, etc.) without disk writes.
• Intelligent "Build Missing Subfolders" Action: The button dynamically reflects real disk state—disabling with ✓ All Subfolders Present when complete to prevent accidental clicks or redundant writes, and activating with Build Missing Subfolders (X) when directories are missing.
• Granular Per-Folder Status Badges: Configured directories display clean status pills (All Subfolders OK (27), Directory Not Found, or ⚠ X missing subfolders ▼) with an expandable drawer detailing missing folder tags and a 1-click Build for this directory button.

📥 Persistent SQLite Download Queue & Batch Management

• Crash & Restart Resilience: Active, paused, and completed download tasks (including progress metrics, elapsed times, and superseding file deletion metadata) are fully persisted to SQLite and hydrated across app relaunches.
• Batch Queue Management: Per-row checkbox selection with "Select All (N)", "Delete Selected (N)", and "Clear All Finished (N)" toolbar actions.
• Immediate Local Library Registration: Completed downloads automatically register into the local library catalog with SHA256 hashes without requiring manual rescans.

🍎 Dedicated macOS Launcher Scripts (cmm-mac.sh / cmm-dev-mac.sh)

• First-Class macOS Support: Added cmm-mac.sh mirroring cmm.sh (Linux) and cmm.ps1 (Windows) with full support for start, stop, restart, status, update, package/dist, and help.
• macOS Native Tooling: Native Electron app resolution (Electron.app/Contents/MacOS/Electron), AppleScript window focus (osascript), Homebrew path detection for Apple Silicon (/opt/homebrew) and Intel (/usr/local), and macOS system process protection blacklists.

🔄 Date-Aware Multi-Install Update Detection

• Upload-Date Comparison: Update checks now evaluate version publishedAt / createdAt upload timestamps instead of raw ID mismatches, eliminating false "update available" notices on older uploads.
• Multi-Install Baseline: When a model is installed across multiple target folders, update checks baseline against the newest installed copy's upload date.
• SHA256 Verification & Sticky Badges: Validates file hashes against CivitAI's published hash manifests (versionFileMatchesHash).

🛡️ Process Security, Janitor Asset Cleanup & Hardening

• Shutdown Protection: Strict blacklists in cmm.sh, cmm.ps1, cmm-mac.sh, and the Electron main process shielding browsers, terminal emulators, and user shells from accidental termination during stop/restart.
• Port Validation: Enforced integer range validation (1024–65535) on --port and --api-port arguments.
• Build-Asset Janitor: Lightweight cleanup pruning stale hashed bundles from dist/assets on stop and restart (npm run clean:assets).
• Official ComfyUI Registry Fallback: Tier 2.5 node resolution querying api.comfy.org/nodes/search when community registries miss node classes.

---

🛠️ Developer & Platform Improvements

• Project Rebranding: Updated technical identifiers, UI strings, documentation, and repository mappings to DevNullInc/RenegadeCMM.
• Model Folders State Persistence: Resolved React state closure issues in Settings ensuring user-configured secondary model directories are preserved on load and save.
• Selectable Diagnostic Logs: Enabled clipboard text selection across the Settings Debug Log, Diagnostic Panels, and About tab logs.
• Parallelized Launchers: Vite renderer and TypeScript main process compile in parallel on start/restart in cmm.ps1, cmm.sh, and cmm-mac.sh.
• First-Run .installed Marker: Launchers skip redundant PATH probing and dependency checks once initialized.
• Documentation: Added comprehensive CONTRIBUTING.md, APISecurity.md, and expanded API_REFERENCE.md.

---

📦 Downloads & Artifacts

Platform	Package Format	File	Size	SHA256 Checksum
Windows (x64)	NSIS Setup Installer	RenegadeCMM Setup 1.4.0.exe	114.39 MB	CB2641BDE9DFD72DB7468FC992B0B3C50D438F8A0C3F13A55B46232BCDA26C7D
Windows (x64)	Portable Standalone	RenegadeCMM-Standalone-v1.4.0.exe	114.17 MB	1E5DA7992AA5305CB6AF34595FE97B1FC09989110B6D0204132C28E49E88F553
Linux (x64)	Debian Package	renegadecmm_1.4.0_amd64.deb	103.07 MB	C7C6525F96D94219919F220AE0BC42ADBB6A9EABE812AADF998F274EFDADE4A1
Linux (x64)	Standalone Archive	renegadecmm-1.4.0.tar.gz	123.89 MB	6D8981A403E0FF7DCAE0B78E1C7B3DAB421580E526E7632A3FA7B7E072A0363C

---

Full Changelog: v1.3.0...v1.4.0

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: https://github.com/DevNullInc/Civitai-manager-ComfyUI/compare/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: https://github.com/DevNullInc/Civitai-manager-ComfyUI/compare/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"