Add a dedicated /health endpoint to ComfyUI

[ondrovic]

Context

ComfyUI currently exposes a /system_stats endpoint which provides useful runtime and system-level information. However, it is not ideal for external monitoring tools that expect a lightweight, standardized health check endpoint.

Many homelab dashboards and service monitors (e.g. Homepage’s siteMonitor integration https://gethomepage.dev/) expect a simple HTTP endpoint that returns a minimal “up/down” status response without additional parsing or overhead.

Problem

/system_stats is not well-suited for health monitoring because:

It returns detailed system metrics rather than a simple status indicator
It may change shape or size depending on implementation updates
External tools must infer health indirectly instead of checking explicitly
It is not aligned with common conventions used by container orchestrators and monitoring systems

As a result, integrating ComfyUI into dashboards like Homepage, Uptime Kuma, or Kubernetes probes requires workarounds.

Proposed Solution

Introduce a dedicated lightweight endpoint:

GET /health

Response

{
  "status": "healthy",
  "timestamp": "2026-06-06T18:13:42.684521"
}

Optional Enhancements (future considerations)

While the initial version should remain minimal, future extensions could include:

• "status": "degraded" when dependencies are available but suboptimal
• "status": "unhealthy" for internal failure states
• optional version field:

"version": "x.y.z"

• optional uptime field:

"uptime": 12345

Benefits

• Enables direct integration with dashboard tools like Homepage
• Standardizes health checking behavior across deployments
• Improves compatibility with container orchestrators (Docker, Kubernetes liveness/readiness probes)
• Keeps monitoring concerns separate from diagnostic/system endpoints
• Reduces parsing complexity for external tools

Compatibility

• Fully backward compatible (no changes to existing endpoints)
• No impact on /system_stats
• No authentication required by default (mirrors typical health check conventions)

Summary

A dedicated /health endpoint would provide a clean, standardized way to monitor ComfyUI instances in homelabs and production-like environments, improving integration with modern dashboards and infrastructure tooling while keeping the API surface clean and predictable.

[ondrovic]

Looks like someone has this #11263 which adds /health along with some other items