This repository hosts open tools that are useful for debugging issues on AMD systems.
amd-debug-tools has been packaged for Arch Linux (and derivatives). You can install it using:
pacman -Sy amd-debug-tools
It is suggested to install tools in a virtual environment either using pipx or python3 -m venv.
amd-debug-tools is distributed as a python wheel, which is a binary package format for Python. To install from PyPI, run the following command:
pipx install amd-debug-tools
To build the package from source, you will need to the python3-build package natively installed by your distribution package manager. Then you can generate and install a wheel by running the following commands:
python3 -m build pipx install dist/amd-debug-tools-*.whl
If you have not used a pipx environment before, you may need to run the following command to set up the environment:
pipx ensurepath
This will add the pipx environment to your path.
Documentation about running directly from a git checkout is available here.
Each tool has its own individual documentation page: