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/prterunand 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
Review controls: q quit | left/right move | down zoom | up zoom out | t threads | d details
1 maintainer
Metadata
1 maintainer
Release files for mpiptop 0.2.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mpiptop-0.2.8.tar.gz | 27.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mpiptop-0.2.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 55.6 kB
Release files / mpiptop-0.2.8.tar.gz
| Download URL | mpiptop-0.2.8.tar.gz |
|---|---|
| Size | 27.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb1667bcb57467e3114dc8b3a933fd80069d23d2fea3fccedff11daf567def38
|
|
BLAKE2b-256 checksum How to use checksums |
2ea6be32fa63ad2f3d9a5e262859dbe5303b1bc94221ea3d9be0ed1dacf77ff7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Apr 1, 2026.
Transparency logRelease files / mpiptop-0.2.8-py3-none-any.whl
| Download URL | mpiptop-0.2.8-py3-none-any.whl |
|---|---|
| Size | 27.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
226fede6841a6d78deadffb82709783d70bf83733166453ddeba3247549d6f8f
|
|
BLAKE2b-256 checksum How to use checksums |
6c500ce82cf9a962c0e5837dea156351678687132b893a0a175d231e53b2df59
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Apr 1, 2026.
Transparency log
