Installing HPCToolkit

We distribute HPCToolkit via source code from the HPCToolkit Project on Gitlab. For most users, we recommend building and installing HPCToolkit (including HPCViewer) with Spack.

Spack Build Instructions (recommended)

For developers, we suggest building HPCToolkit with Meson.

Meson Build Instructions (for developers)

Installing HPCViewer

HPCViewer is a graphical user interface needed to explore performance databases produced by HPCToolkit. If you use Spack to install HPCToolkit on a Linux system, HPCviewer will be installed as well by default. You may also want to use HPCViewer on a system where you have not installed HPCToolkit, e.g. your laptop. There are several ways to do that.

Downloading a Binary Release

Manually installing a binary release (recommended for MacOS, and Windows; available for Linux)
Installing a binary release with Spack (recommended for Linux; available for MacOS)

Building from Source

Unless you are a tool developer, we recommend downloading a binary release.

Source code for HPCViewer is available from its Gitlab repository. Directions for building HPCViewer from source on Linux, MacOS, and Windows are in available in INSTALL.md in HPCViewer's Gitlab repository.

[Page last updated: 2025/09/10]

Copyright © HPCToolkit Project a Series of LF Projects, LLC
For web site terms of use, trademark policy and other project policies please see https://lfprojects.org.