> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfycontrol.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Runner Stats

> Retrieve system statistics and information for a runner

## Overview

Fetch real-time system statistics from a ComfyUI runner, including hardware information, resource usage, installed extensions, and configuration settings.

<Note>
  This endpoint makes a live request to your ComfyUI instance, so response time depends on your runner's network latency.
</Note>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier (UUID) of the runner to query.
</ParamField>

## Response

<ResponseField name="system" type="object" required>
  System information.
</ResponseField>

<ResponseField name="system.os" type="string">
  Operating system name.
</ResponseField>

<ResponseField name="system.ram_free" type="integer">
  Free RAM in bytes.
</ResponseField>

<ResponseField name="system.ram_total" type="integer">
  Total RAM in bytes.
</ResponseField>

<ResponseField name="system.comfyui_version" type="string">
  ComfyUI version number.
</ResponseField>

<ResponseField name="system.python_version" type="string">
  Python version running ComfyUI.
</ResponseField>

<ResponseField name="devices" type="array" required>
  Array of compute devices (GPUs/CPUs) available to ComfyUI.
</ResponseField>

<ResponseField name="devices[].name" type="string">
  Device name/model.
</ResponseField>

<ResponseField name="devices[].type" type="string">
  Device type (e.g., "cuda", "cpu", "mps").
</ResponseField>

<ResponseField name="devices[].vram_total" type="integer">
  Total VRAM in bytes (for GPUs).
</ResponseField>

<ResponseField name="devices[].vram_free" type="integer">
  Free VRAM in bytes (for GPUs).
</ResponseField>

<ResponseField name="dev_mode" type="boolean" required>
  Whether ComfyUI is running in development mode.
</ResponseField>

<ResponseField name="extensions" type="string[]" required>
  Array of installed ComfyUI extensions/custom nodes.
</ResponseField>

## Example Response

```json theme={null}
{
  "system": {
    "os": "posix",
    "ram_free": 239499096064,
    "ram_total": 253344550912,
    "comfyui_version": "0.3.77",
    "python_version": "3.12.12 (main, Oct 15 2025, 09:20:08) [GCC]"
  },
  "devices": [
    {
      "name": "cuda:0 NVIDIA H100 80GB HBM3 : cudaMallocAsync",
      "type": "cuda",
      "vram_total": 84942848000,
      "vram_free": 84316848128
    }
  ],
  "dev_mode": true,
  "extensions": [
    "/extensions/core/groupNodeManage.js",
    "/extensions/core/groupNode.js",
    "/extensions/ComfyUI-Manager/comfyui-manager.js",
    "/extensions/rgthree-comfy/rgthree.js"
  ]
}
```

## Error Responses

<ResponseField name="401" type="error">
  Unauthorized - invalid or missing authentication token.
</ResponseField>

<ResponseField name="404" type="error">
  Not Found - runner with the specified ID does not exist or does not belong to your account.
</ResponseField>

<ResponseField name="500" type="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
</ResponseField>

## 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