Helpful tools for debugging AMD Zen systems

This repository hosts open tools that are useful for debugging issues on AMD systems.

Installation

Distro (Arch)

amd-debug-tools has been packaged for Arch Linux (and derivatives). You can install it using:

pacman -Sy amd-debug-tools

Using a python wheel (Generic)

It is suggested to install tools in a virtual environment either using pipx or python3 -m venv.

From PyPI

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

From source

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

Ensuring path

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.

Running in-tree

Documentation about running directly from a git checkout is available here.

Tools

Each tool has its own individual documentation page:

Download files

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

Source Distribution

amd_debug_tools-0.2.21.tar.gz (126.3 kB view details)

Uploaded Aug 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

amd_debug_tools-0.2.21-py3-none-any.whl (135.7 kB view details)

Uploaded Aug 24, 2026 Python 3

File details

Details for the file amd_debug_tools-0.2.21.tar.gz.

File metadata

Download URL: amd_debug_tools-0.2.21.tar.gz
Upload date: Aug 24, 2026
Size: 126.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for amd_debug_tools-0.2.21.tar.gz
Algorithm	Hash digest
SHA256	`1fde40c0ab168ae387463e4ca310b62958498d74d14e20f20e3fc61c134839ef`
MD5	`0e420a0389c1c4502a95cc3308088494`
BLAKE2b-256	`05360653aebb12d044fdcfca348d948010e5818067023289333fc3ad8d6638b3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for amd_debug_tools-0.2.21.tar.gz:

Publisher: ci.yml on superm1/amd-debug-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: amd_debug_tools-0.2.21.tar.gz
- Subject digest: 1fde40c0ab168ae387463e4ca310b62958498d74d14e20f20e3fc61c134839ef
- Sigstore transparency entry: 2581792513
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: superm1/amd-debug-tools@acc87499f28855bfe36071873d565300e692d160
- Branch / Tag: refs/tags/0.2.21
- Owner: https://github.com/superm1
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@acc87499f28855bfe36071873d565300e692d160
- Trigger Event: push