Setmaster ded1edfb98 Add Phase 2 features: search and settings panel
- Add search/filter bar with debounced input
- Add settings panel with configurable stale threshold (1-365 days)
- Settings persist to localStorage
- Show "no results" message when search returns empty
- Stale highlighting now respects user-configured threshold
2026-01-14 23:01:20 -05:00

ModelPulse

A ComfyUI extension that tracks model usage frequency, helping you identify abandoned or underutilized models to manage storage efficiently.

ComfyUI Python Platform

Features

  • Automatic Tracking - Monitors usage of all model types: checkpoints, LoRAs, VAEs, ControlNets, CLIP, UNETs, upscalers, and more
  • Sidebar Panel - View usage statistics directly in ComfyUI's sidebar
  • Time Filtering - View usage for all time, this month, or this week
  • Smart Sorting - Sort by last used, usage count, or name
  • Stale Detection - Models unused for 30+ days are highlighted
  • Category Grouping - Models organized by type with collapsible sections
  • Zero Dependencies - Uses only Python standard library

Installation

Search for "ModelPulse" in ComfyUI Manager and click Install.

Option 2: Manual Installation

cd ComfyUI/custom_nodes
git clone https://github.com/your-username/ComfyUI-ModelPulse.git

Restart ComfyUI after installation.

Usage

  1. Click the chart icon in the ComfyUI sidebar to open ModelPulse
  2. Run workflows as usual - model usage is tracked automatically
  3. Use the tabs to filter by time period (All Time / Month / Week)
  4. Use the dropdown to sort by Last Used, Usage Count, or Name
  5. Click category headers to collapse/expand sections

Tracked Model Types

Category Loader Nodes
Checkpoints CheckpointLoaderSimple, CheckpointLoader
LoRAs LoraLoader, LoraLoaderModelOnly
VAEs VAELoader
ControlNets ControlNetLoader
CLIP CLIPLoader, DualCLIPLoader
UNETs UNETLoader
Upscalers UpscaleModelLoader
Style Models StyleModelLoader
GLIGEN GLIGENLoader

Custom node loaders (Impact Pack, Efficiency Nodes, etc.) are also detected via pattern matching.

API Endpoints

ModelPulse exposes REST endpoints for programmatic access:

Endpoint Method Description
/modelpulse/usage GET Get all usage data (supports ?timeframe= and ?sort= params)
/modelpulse/model/{id} GET Get detailed data for a specific model
/modelpulse/categories GET Get category list with counts
/modelpulse/reset POST Reset all tracking data (requires {"confirm": true})

Data Storage

Usage data is stored in:

ComfyUI/user/default/modelpulse/usage_data.json

The data persists across ComfyUI restarts and can be backed up or edited manually.

Requirements

  • ComfyUI 0.3.0 or later (Vue 3 frontend)
  • Python 3.10+
  • No external Python dependencies

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

S
Description
No description provided
Readme MIT
78 KiB
Languages
Python 53.1%
JavaScript 46.9%