🔍 ComfyUI HealthCheck

A lightweight health check plugin for ComfyUI that monitors custom node import status and provides colorful summary reports.

Features

• 📦 Auto-count total installed plugins (folders + .py files)
• ✅ Detect successful imports via real-time log capture
• ❌ List failed plugins with full paths for easy troubleshooting
• 📊 Health percentage calculation (success rate)
• 🧠 Total node classes count
• 🎨 Colorful console output (ANSI colors)
• ⏱️ Delayed reporting (after all plugins loaded)

Installation

Method 1: ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Click "Custom Nodes Manager"
3. Search for "HealthCheck"
4. Install and restart

Method 2: Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/love530love/ComfyUI-HealthCheck.git

Method 3: Manual

1. Download ComfyUI_HealthCheck.py from Releases
2. Copy to ComfyUI/custom_nodes/
3. Restart ComfyUI

Usage

No configuration needed. After ComfyUI starts, check the console output:

============================================================
                    🚀 ComfyUI Plugin Health Report
============================================================
📦 Total Plugins: 306 (folders: 289, .py: 17)
✅ Successful: 305
❌ Failed: 1
📊 Health: 99.7%
🧠 Node Classes: 6890

🚨 Failed Plugins:
✗ Example-Plugin
  └─ H:\ComfyUI\custom_nodes\Example-Plugin

💡 Troubleshooting Hint:
Search the startup log above for Traceback, Cannot import, ModuleNotFoundError, or ImportError.
============================================================

How It Works

1. Disguised as Node: Registers a dummy node to avoid "IMPORT FAILED"
2. Log Capture: Temporarily redirects stdout/stderr to detect "(IMPORT FAILED)" markers
3. Delayed Output: Waits briefly after import timing output so plugins can finish loading
4. Troubleshooting Hint: Reminds you which log keywords to search when a plugin import fails
5. Color Report: ANSI-colored summary in console

Compatibility

• Windows / Linux / macOS
• Python 3.8+
• ComfyUI 0.1.0+

Links

• GitHub: https://github.com/love530love/ComfyUI-HealthCheck
• Issues: https://github.com/love530love/ComfyUI-HealthCheck/issues
• CSDN Blog: https://aicity.blog.csdn.net/article/details/156202270

License

MIT License