gpustat

📊 A simple command-line utility for querying and monitoring GPU status

What is gpustat?

📊 A simple command-line utility for querying and monitoring GPU status

Overview of gpustat

What it is

gpustat is a command-line utility for querying and monitoring GPU status. It supports NVIDIA GPUs through NVML, AMD GPUs through ROCm SMI, and Huawei Ascend 910B NPUs through npu-smi.

Key features

  • Displays GPU index, name, temperature, utilization, memory usage, and running processes.
  • Supports colored output, JSON output, and watch mode for periodic updates.
  • Can show additional details such as username, command, PID, fan speed, codec utilization, and power usage.
  • Allows targeting specific GPUs by index and selecting the backend (auto, nvidia, amd, or ascend).
  • Provides a Python API for querying GPU status programmatically.

Use cases

  • Monitoring GPU health and utilization in development or production environments.
  • Debugging GPU memory usage and process allocation.
  • Integrating GPU status into scripts or monitoring dashboards.

Getting started

Install from PyPI:pip install gpustatTo install the latest version from GitHub:pip install git+https://github.com/wookayin/gpustat.git@masterAfter installation, run gpustat to display GPU status.

License and pricing

This project is licensed under the MIT License. It is open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/wookayingpustat.svg)](https://yunodb.com/tools/wookayingpustat?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/wookayingpustat?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/wookayingpustat.svg" alt="Featured on YunoDB" height="20"></a>