mpiptop

mpiptop screenshot

mpiptop - live, side-by-side Python stack traces across MPI ranks.

A focused TUI that makes distributed debugging feel calm and fast.

Why it helps

Auto-detects active mpirun/prterun and its rankfile
One column per rank with subtle diff highlights
Toggle main thread vs all threads, and a details panel
Works over passwordless SSH; propagates venv env vars

Install

pip install mpiptop

Usage

mpiptop

Common options:

mpiptop --rankfile /etc/mpirun/rankfile_01_02
mpiptop --prterun-pid 12345
mpiptop --slurm-job 123456
mpiptop --refresh 5
mpiptop --pythonpath /path/to/your/code
mpiptop record --out ./mpiptop-session-20260123-120000.jsonl

Slurm notes: if SLURM_JOB_ID is set or you have exactly one running job, mpiptop will auto-detect it.

Record/review (record is batch mode; use plain mpiptop for the TUI):

mpiptop record
mpiptop record --quiet
mpiptop review ./mpiptop-session-20260123-120000.jsonl
mpiptop summarize ./mpiptop-session-20260123-120000.jsonl --format text

Live controls: q quit | space refresh | t threads | d details | r record

Download files

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

Source Distribution

mpiptop-0.2.8.tar.gz (27.7 kB view details)

Uploaded Apr 1, 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.

mpiptop-0.2.8-py3-none-any.whl (27.9 kB view details)

Uploaded Apr 1, 2026 Python 3

File details

Details for the file mpiptop-0.2.8.tar.gz.

File metadata

Download URL: mpiptop-0.2.8.tar.gz
Upload date: Apr 1, 2026
Size: 27.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mpiptop-0.2.8.tar.gz
Algorithm	Hash digest
SHA256	`cb1667bcb57467e3114dc8b3a933fd80069d23d2fea3fccedff11daf567def38`
MD5	`8726671f1004a24bccac39e063b8828d`
BLAKE2b-256	`2ea6be32fa63ad2f3d9a5e262859dbe5303b1bc94221ea3d9be0ed1dacf77ff7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mpiptop-0.2.8.tar.gz:

Publisher: workflow.yml on yieldthought/mpiptop

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: mpiptop-0.2.8.tar.gz
- Subject digest: cb1667bcb57467e3114dc8b3a933fd80069d23d2fea3fccedff11daf567def38
- Sigstore transparency entry: 1205773968
- Sigstore integration time: Apr 1, 2026
Source repository:
- Permalink: yieldthought/mpiptop@f2286bed9c0d4ddbbb23923a360a4f904198723a
- Branch / Tag: refs/tags/v0.2.8
- Owner: https://github.com/yieldthought
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: workflow.yml@f2286bed9c0d4ddbbb23923a360a4f904198723a
- Trigger Event: push