Skip to main content

mnvitop

One terminal for the GPUs of all your ssh hosts. It runs nvidia-smi over ssh and shows every host's GPUs, their memory, utilisation history and running processes in a single live view. Nothing needs to be installed on the remote side beyond nvidia-smi and ps. It also ships an MCP server, so an agent can ask where a free GPU is.

mnvitop watching three GPU hosts

Install

uv tool install mnvitop

You need Python 3.11 or newer locally and ssh access to the hosts. To get the MCP server as well, install mnvitop[mcp].

Use

mnvitop h20 semi pro6000

Each argument is an ssh destination, either an alias from ~/.ssh/config or user@host. Ctrl-C quits.

mnvitop -a        # temperature, process cpu and memory, more processes per GPU
mnvitop --once    # print once and exit
mnvitop --json    # one JSON line per round, for logging

mnvitop --help lists the rest. To stop typing the hosts every time, put them in ~/.config/mnvitop/hosts.toml, following hosts.example.toml.

For agents, mnvitop-mcp is a stdio MCP server with three tools: find_gpus, fleet_status and list_hosts. Register it in Claude Code with claude mcp add mnvitop -- mnvitop-mcp. The repository also carries a matching skill in skills/gpu-fleet.

MIT license.

Metadata

Release files for mnvitop 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mnvitop 1.0.0
File Size Uploaded Provenance
mnvitop-1.0.0.tar.gz 825.2 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for mnvitop 1.0.0
File Interpreter ABI Platform
mnvitop-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 850.2 kB

Release files / mnvitop-1.0.0.tar.gz

Download URL mnvitop-1.0.0.tar.gz
Size 825.2 kB
Tags Source
SHA-256 checksum
How to use checksums
1248c4d827a95943afe16bc9eb86a2501a97ef047eb4d98893259c3fb0a4ea4f
BLAKE2b-256 checksum
How to use checksums
695707af4689b52ea86c84059596ae4e998b157a47f436d6a9b8be559c20cc1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 10, 2026.

Transparency log

Release files / mnvitop-1.0.0-py3-none-any.whl

Download URL mnvitop-1.0.0-py3-none-any.whl
Size 25.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0998ce5f8964f95c1ecff19f3f02874fa3352b9e4ac9163f164eba9f2d61a307
BLAKE2b-256 checksum
How to use checksums
0dbeaa4ea88b1529790e0dc4a61d80b28bbc0a926a637ac75e199a653cb5b055
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 10, 2026.

Transparency log

Security for mnvitop 1.0.0

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mnvitop-1.0.0.tar.gz

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 Sep 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page