mpiptop 0.2.3

TUI for viewing MPI Python stacks across hosts

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

Review controls: q quit | left/right move | down zoom | up zoom out | t threads | d details