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

This version

0.2.2

0.2.1

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.2.tar.gz (21.7 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.2-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mpiptop-0.2.2.tar.gz
  • Upload date:
  • Size: 21.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.2.tar.gz
Algorithm Hash digest
SHA256 2e06c349657a2040a9ff737796cbd6fdb9105cf0f18d4c23b35958db9b3aa64c
MD5 655e725bbe644ca38169729e3db89b44
BLAKE2b-256 29785b4d58fcb025dfbe3f7c96dc8cfc13ce9c95e70f93af20edf8471df6a8a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for mpiptop-0.2.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: mpiptop-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 22.0 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6bf59b82a0f4b212b538e234d3c47a8775d7b9d48afa0ba7cccf665c0794cf32
MD5 5f7a49f137120536a87cac79431d6c7e
BLAKE2b-256 3e49532ce95f5d645dda74c7537056866ce697ab222e7f48883ca363dfcf394c

See more details on using hashes here.

Provenance

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