Extensions/ComfyUI HealthCheck

ComfyUI Extension

ComfyUI HealthCheck

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

By love530love·Created 4 months ago·Updated about a month ago· 1

love530love/ComfyUI-HealthCheck

Nodes1

On cloudLocal install

Categoryutils

Stars1

Updatedabout a month ago

Nodes (1)

Health Check (Internal)

utils

Readme

🔍 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)

Open ComfyUI Manager
Click "Custom Nodes Manager"
Search for "HealthCheck"
Install and restart

Method 2: Git Clone

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

Method 3: Manual

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

Usage

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

============================================================

 ██████╗   ██████╗   ███╗   ███╗  ███████╗  ██╗   ██╗  ██╗  ██╗  ██╗
██╔════╝  ██╔═══██╗  ████╗ ████║  ██╔════╝  ╚██╗ ██╔╝  ██║  ██║  ██║
██║       ██║   ██║  ██╔████╔██║  █████╗     ╚████╔╝   ██║  ██║  ██║
██║       ██║   ██║  ██║╚██╔╝██║  ██╔══╝      ╚██╔╝    ██║  ██║  ██║
╚██████╗  ╚██████╔╝  ██║ ╚═╝ ██║  ██║          ██║     ╚████╔╝   ██║
 ╚═════╝   ╚═════╝   ╚═╝     ╚═╝  ╚═╝          ╚═╝      ╚═══╝    ╚═╝

██╗  ██╗  ███████╗   █████╗   ██╗    ████████╗  ██╗  ██╗   ██████╗  ██╗  ██╗  ███████╗   ██████╗  ██╗  ██╗
██║  ██║  ██╔════╝  ██╔══██╗  ██║    ╚══██╔══╝  ██║  ██║  ██╔════╝  ██║  ██║  ██╔════╝  ██╔════╝  ██║ ██╔╝
███████║  █████╗    ███████║  ██║       ██║     ███████║  ██║       ███████║  █████╗    ██║       █████╔╝
██╔══██║  ██╔══╝    ██╔══██║  ██║       ██║     ██╔══██║  ██║       ██╔══██║  ██╔══╝    ██║       ██╔═██╗
██║  ██║  ███████╗  ██║  ██║  ███████╗  ██║     ██║  ██║  ╚██████╗  ██║  ██║  ███████╗  ╚██████╗  ██║  ██╗
╚═╝  ╚═╝  ╚══════╝  ╚═╝  ╚═╝  ╚══════╝  ╚═╝     ╚═╝  ╚═╝   ╚═════╝  ╚═╝  ╚═╝  ╚══════╝   ╚═════╝  ╚═╝  ╚═╝

   🔍 ComfyUI HealthCheck v1.0.9

============================================================
             🚀 ComfyUI Plugin Health Report
============================================================
📦 扫描到已有的插件数/Total Plugins: 320 (其中 插件文件夹数/folders: 304, 单独以 .py 形式存在的插件数/.py: 16)
✅ 已成功加载的插件数/Successful: 320
❌ 加载失败需要排查原因的插件数/Failed: 0
📊 健康度/Health: 100.0%
🧠 已成功扫描到的节点数/Node Classes: 7083

🎉 所有插件加载成功！/All plugins loaded successfully!

检测时间戳/Checked at: 2026-07-03 12:18:19
============================================================

When a plugin fails to import, the report also shows the failed plugin paths and a troubleshooting hint:

Failed plugin example

============================================================
             🚀 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.
============================================================

Screenshots

All plugins loaded (Health 100%)

All plugins loaded successfully

Plugin import failed (Health < 100%)