Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

AMD GPU stats

Project description


AMD GPU stats


pip3 install pyamdgpuinfo

Only linux is supported, using the amdgpu driver.

Precompiled wheels for python 3.5, 3.6 and 3.7 are the default method of install. This means that you don't need cython or any other dependencies to install it normally.

Currently, prebuilt wheels are unavailable due to Centos 6 shipping a libdrm version which is too old. However, the manylinux2014 PEP (599) allows Centos 7, which ships a new enough version. This means that prebuilt wheels should be available soon.

The library is written using cython, meaning that cython and and a C compiler are needed to build and install from source. Additionally, libdrm-dev is needed.



import pyamdgpuinfo

gpus = pyamdgpuinfo.setup_devices()
# query first device
first_gpu = list(gpus.keys())[0]
vram_usage = pyamdpuinfo.query_vram_usage(first_gpu)

All documentation is in the docstrings of each function/class.

Available functions are (see docstrings for more info):

  • setup_devices - Sets up devices so they can be used.
  • start_utilisation_polling - Starts polling GPU registers for utilisation statistics.
  • stop_utilisation_polling - Stops the utilisation polling thread.
  • cleanup - Cleans up allocated memory (only recommended if de-initialising the module before the main program is ended).

Query functions (again see docstrings):

  • query_max_clocks - Queries max GPU clocks
  • query_sclk - Queries shader (core) clock
  • query_mclk - Queries memory clock
  • query_vram_usage - Queries VRAM usage
  • query_gtt_usage - Queries GTT usage
  • query_temp - Queries temperature
  • query_load - Queries GPU load
  • query_power - Queries power consumption
  • query_utilisation - Queries utilisation of different GPU parts (requires utilisation polling to be running)

VRAM and GTT sizes are returned by setup_devices (if they are available).


Parts of this package were inspired by radeontop.



Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyamdgpuinfo, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size pyamdgpuinfo-1.0.2.tar.gz (7.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page