An interactive NVIDIA-GPU process viewer and beyond, the one-stop solution for GPU process management.
  • Python 96.8%
  • Shell 2.9%
  • Dockerfile 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2021-02-05 14:34:15 +08:00
nvhtop chore: refactor displayable 2021-02-05 14:34:15 +08:00
.gitignore chore: update .gitignore file 2021-01-29 12:10:06 +08:00
LICENSE Initial commit 2021-01-25 20:17:03 +08:00
MANIFEST.in chore: pack packages 2021-02-05 13:30:21 +08:00
nvhtop.py chore: pack packages 2021-02-05 13:30:21 +08:00
README.md docs: update README.md 2021-02-05 13:51:36 +08:00
requirements.txt refactor: refactor nvhtop 2021-02-04 17:17:41 +08:00
setup.cfg chore: pack packages 2021-02-05 13:30:21 +08:00
setup.py chore: pack packages 2021-02-05 13:30:21 +08:00

nvhtop

An interactive Nvidia-GPU process viewer. (Under progress)

Requirements

  • Python 3.5+
  • curses
  • nvidia-ml-py
  • psutil
  • cachetools
  • termcolor

Installation

From GitHub:

$ pip install git+https://github.com/XuehaiPan/nvhtop.git#egg=nvhtop

Or, download and pip install:

$ git clone --depth=1 https://github.com/XuehaiPan/nvhtop.git
$ cd nvhtop
$ pip install .

Usage

Query the device status. The output is similar to nvidia-smi, but has been enriched and colorized.

$ nvhtop

Run as a resource monitor, like htop:

# Automatically configure the display mode according to the terminal size
$ nvhtop --monitor
$ nvhtop --monitor auto

# Forcibly display as `full` mode
$ nvhtop --monitor full

# Forcibly display as `compact` mode
$ nvhtop --monitor compact

Press q to return to the terminal.

Type nvhtop --help for more information:

usage: nvhtop [-h] [-m [{auto,full,compact}]]

A interactive Nvidia-GPU process viewer.

optional arguments:
  -h, --help        show this help message and exit
  -m [{auto,full,compact}], --monitor [{auto,full,compact}]
                    Run as a resource monitor. Continuously report query data,
                    rather than the default of just once.
                    If no argument is specified, the default mode `auto` is used.

Screenshots

Example output of nvhtop:

Screenshot

Example output of nvhtop --monitor:

Full Compact