TUI for viewing MPI Python stacks across hosts

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for yieldthought from gravatar.com yieldthought

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: yieldthought
  • Tags mpi , tui , py-spy , distributed , debugging
  • Requires: Python >=3.8
Classifiers
Report project as malware

Project description

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 --refresh 5
mpiptop --pythonpath /path/to/your/code
mpiptop record --out ./mpiptop-session-20260123-120000.jsonl

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

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for yieldthought from gravatar.com yieldthought

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: yieldthought
  • Tags mpi , tui , py-spy , distributed , debugging
  • Requires: Python >=3.8
Classifiers

Release history Release notifications | RSS feed

0.2.8

0.2.7

0.2.6

0.2.5

0.2.4

0.2.3

0.2.2

0.2.1

This version

0.2.0

0.1.1

0.1.0

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.0.tar.gz (21.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mpiptop-0.2.0-py3-none-any.whl (21.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mpiptop-0.2.0.tar.gz
  • Upload date:
  • Size: 21.2 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.0.tar.gz
Algorithm Hash digest
SHA256 e15af91c7b0995c132044308250f307ca179b1924a4a8280d3a89499ef396303
MD5 c6406100a71fe89a901ea0165e6e32dd
BLAKE2b-256 650f74b0c00e6d8e46ccd659632b4e2c62b9bb2c0e5f50ab85de1877169aaf10

See more details on using hashes here.

Provenance

The following attestation bundles were made for mpiptop-0.2.0.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.

File details

Details for the file mpiptop-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: mpiptop-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 21.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mpiptop-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 198fe9a9ab12b99cc1f839c4a40cf53939fe5ce6c6f9d1487774ceed2023a66d
MD5 1bbe0166e9cd2c051446ef1429897918
BLAKE2b-256 d42d24ba765e7e55f502ebd77e4f218f8d0b3cf539ab282fbc04b9fe37ab9212

See more details on using hashes here.

Provenance

The following attestation bundles were made for mpiptop-0.2.0-py3-none-any.whl:

Publisher: workflow.yml on yieldthought/mpiptop

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page