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.
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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mnvitop-1.0.0.tar.gz | 825.2 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.