Skip to main content

[![pypi](https://img.shields.io/pypi/v/gpustat.svg?maxAge=86400)][pypi_gpustat] [![Build Status](https://travis-ci.org/wookayin/gpustat.svg?branch=master)](https://travis-ci.org/wookayin/gpustat) [![license](https://img.shields.io/github/license/wookayin/gpustat.svg?maxAge=86400)](LICENSE)

Just less than nvidia-smi?

![Screenshot: gpustat -cp](screenshot.png)

Usage

$ gpustat

Options:

  • –no-color : Suppress color (by default, color is enabled)

  • -u, –show-user : Display username of the process owner

  • -c, –show-cmd : Display the process name

  • -p, –show-pid : Display PID of the process

  • –json : JSON Output (Experimental, #10)

### Tips

  • To periodically watch, try watch –color -n1.0 gpustat (built-in watch support will be added soon).

  • Running nvidia-smi daemon (root privilege required) will make the query much faster.

  • The GPU ID (index) shown by gpustat (and nvidia-smi) is PCI BUS ID, while CUDA differently assigns the fastest GPU with the lowest ID by default. Therefore, in order to make CUDA and gpustat use same GPU index, configure the CUDA_DEVICE_ORDER environment variable to PCI_BUS_ID (before setting CUDA_VISIBLE_DEVICES for your CUDA program): export CUDA_DEVICE_ORDER=PCI_BUS_ID

Quick Installation

Install from [PyPI][pypi_gpustat]:

` sudo pip install gpustat `

To install the latest version (master branch) via pip:

` pip install git+https://github.com/wookayin/gpustat.git@master `

Alternatively, you can just download an unstable version of [gpustat.py][script_gitio] (or any [stable version][script_stable]) into somewhere in PATH, e.g. ~/.local/bin/ (when you do not have root privilege, for example):

` sudo wget https://git.io/gpustat.py -O /usr/local/bin/gpustat && sudo chmod +x /usr/local/bin/gpustat `

[pypi_gpustat]: https://pypi.python.org/pypi/gpustat [script_gitio]: https://git.io/gpustat.py [script_stable]: https://raw.githubusercontent.com/wookayin/gpustat/v0.2.0/gpustat.py

License

[MIT License](LICENSE)

Metadata

Release files for gpustat 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gpustat 0.3.1
File Size Uploaded
gpustat-0.3.1.tar.gz 6.4 kB Details

Release files / gpustat-0.3.1.tar.gz

Download URL gpustat-0.3.1.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6cfdb61695a872cbccc898803329d4ea525f306c7722c08bd34f6ca15e4f2432
BLAKE2b-256 checksum
How to use checksums
4b527284526b2c8a2e86d2a1b8d144bb7fd9492cb209b45778501ac1f16f0e5c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

1.1.1

1 release file

1.1

1 release file

1.0.0

1 release file

0.6.0

1 release file

0.5.0

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.3.2

1 release file

This release

0.3.1 This release

1 release file

0.2.0

1 release file

0.1.1

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page