Skip to main content

Helpful tools for debugging AMD Zen systems

codecov PyPI

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:

Release files for amd-debug-tools 0.2.21

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

Source distribution (sdist)

Source distribution for amd-debug-tools 0.2.21
File Size Uploaded
amd_debug_tools-0.2.21.tar.gz 126.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for amd-debug-tools 0.2.21
File Interpreter ABI Platform
amd_debug_tools-0.2.21-py3-none-any.whl Python 3 none any Details

Total release size: 262.0 kB

Release files / amd_debug_tools-0.2.21.tar.gz

Download URL amd_debug_tools-0.2.21.tar.gz
Size 126.3 kB
Tags Source
SHA-256 checksum
How to use checksums
1fde40c0ab168ae387463e4ca310b62958498d74d14e20f20e3fc61c134839ef
BLAKE2b-256 checksum
How to use checksums
05360653aebb12d044fdcfca348d948010e5818067023289333fc3ad8d6638b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 24, 2026.

Transparency log

Release files / amd_debug_tools-0.2.21-py3-none-any.whl

Download URL amd_debug_tools-0.2.21-py3-none-any.whl
Size 135.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1147b15cbfe6578efc63ffdc3c674ccf38b4a7d6e1fe540c14764a854031f48c
BLAKE2b-256 checksum
How to use checksums
615c5d2024ab89d0359c30db5591ff57658408cb4ee743d245e8742e40dc4fd7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 24, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.21 This release

2 release files

0.2.20

2 release files

0.2.18

2 release files

0.2.16

2 release files

0.2.15

2 release files

0.2.12

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

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