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:

Metadata

Release files for amd-debug-tools 0.2.22

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.22
File Size Uploaded
amd_debug_tools-0.2.22.tar.gz 136.5 kB Details

Built distribution (wheel)

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

Total release size: 283.2 kB

Release files / amd_debug_tools-0.2.22.tar.gz

Download URL amd_debug_tools-0.2.22.tar.gz
Size 136.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3d75ecfe3c18de471b57128b363155e39e3e8b7415a32356a85487a6c84f77df
BLAKE2b-256 checksum
How to use checksums
0b76a57266fbb73f84a9c76e23f12a5856ebc9fd7d842926815ff4764eef7ea6
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 Oct 7, 2026.

Transparency log

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

Download URL amd_debug_tools-0.2.22-py3-none-any.whl
Size 146.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9316c6f5c6c86fa9db0577894913b2f539dc81e308d39305f890bd6c69d0462c
BLAKE2b-256 checksum
How to use checksums
b3852a2532e592cf3feff30e60a729efb9e8c0f1adb78f3728d612c093b5d464
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 Oct 7, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.22 This release

2 release files

0.2.21

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