Favicon of gpustat

gpustat

A command-line GPU monitor that runs locally on NVIDIA hardware, shows memory use and running processes, and provides JSON output under the MIT license.

gpustat is a local command-line GPU monitor for people running AI models or other workloads on NVIDIA hardware. It puts GPU activity and the processes using each device into a compact terminal view, useful when you need to check memory use or see who’s occupying a shared GPU. It's open source under the MIT license.

The default display shows each GPU's name, temperature, utilization, and used versus total memory. It also shows running GPU processes and their memory consumption. Process details can include the owner's username, process ID, and full command, so you can connect resource use to a particular job rather than just see that a device is busy.

For longer-running workloads, watch mode refreshes the display at a chosen interval. You can inspect selected GPUs and include fan speed, power draw and limits, or video encoder and decoder utilization. Colored output helps separate the readings in the terminal, and you can hide process information when you only need device statistics.

The tool also fits into scripts: it can return JSON, and its Python API exposes GPU queries to your own code. It reads NVIDIA's monitoring data through NVML using the official nvidia-ml-py bindings. gpustat requires an NVIDIA driver and supports NVIDIA GPUs only; it doesn't support AMD hardware.

Similar to gpustat