Get Runner Stats
Runners
Get Runner Stats
Retrieve system statistics and information for a runner
GET
Get Runner Stats
Overview
Fetch real-time system statistics from a ComfyUI runner, including hardware information, resource usage, installed extensions, and configuration settings.This endpoint makes a live request to your ComfyUI instance, so response time depends on your runner’s network latency.
Path Parameters
string
required
The unique identifier (UUID) of the runner to query.
Response
object
required
System information.
string
Operating system name.
integer
Free RAM in bytes.
integer
Total RAM in bytes.
string
ComfyUI version number.
string
Python version running ComfyUI.
array
required
Array of compute devices (GPUs/CPUs) available to ComfyUI.
string
Device name/model.
string
Device type (e.g., “cuda”, “cpu”, “mps”).
integer
Total VRAM in bytes (for GPUs).
integer
Free VRAM in bytes (for GPUs).
boolean
required
Whether ComfyUI is running in development mode.
string[]
required
Array of installed ComfyUI extensions/custom nodes.
Example Response
Error Responses
error
Unauthorized - invalid or missing authentication token.
error
Not Found - runner with the specified ID does not exist or does not belong to your account.
error
Internal Server Error - unable to connect to the runner or retrieve stats.Common causes:
- Runner endpoint is unreachable
- Runner is offline or not responding
- Network connectivity issues
- Invalid authentication headers configured for the runner
Notes
- This endpoint makes a live request to your ComfyUI instance
- Response time varies based on network latency
- VRAM and RAM values are in bytes (divide by 1,073,741,824 for GB)
- Use this to monitor runner health and capacity before scheduling workflows
- System information includes ComfyUI version and Python version details