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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mnvitop-1.0.0.tar.gz.
File metadata
- Download URL: mnvitop-1.0.0.tar.gz
- Upload date:
- Size: 825.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1248c4d827a95943afe16bc9eb86a2501a97ef047eb4d98893259c3fb0a4ea4f
|
|
| MD5 |
0edbf89f81d8763bd13f33b47863cc73
|
|
| BLAKE2b-256 |
695707af4689b52ea86c84059596ae4e998b157a47f436d6a9b8be559c20cc1f
|
Provenance
The following attestation bundles were made for mnvitop-1.0.0.tar.gz:
Publisher:
publish.yml on kangkangzi2025/mnvitop
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mnvitop-1.0.0.tar.gz -
Subject digest:
1248c4d827a95943afe16bc9eb86a2501a97ef047eb4d98893259c3fb0a4ea4f - Sigstore transparency entry: 2779029238
- Sigstore integration time:
-
Permalink:
kangkangzi2025/mnvitop@488578eccd96766209997961af0dc62cbb4f3e47 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/kangkangzi2025
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@488578eccd96766209997961af0dc62cbb4f3e47 -
Trigger Event:
push
-
Statement type:
File details
Details for the file mnvitop-1.0.0-py3-none-any.whl.
File metadata
- Download URL: mnvitop-1.0.0-py3-none-any.whl
- Upload date:
- Size: 25.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0998ce5f8964f95c1ecff19f3f02874fa3352b9e4ac9163f164eba9f2d61a307
|
|
| MD5 |
bd45a55f129757edba89386ed0849877
|
|
| BLAKE2b-256 |
0dbeaa4ea88b1529790e0dc4a61d80b28bbc0a926a637ac75e199a653cb5b055
|
Provenance
The following attestation bundles were made for mnvitop-1.0.0-py3-none-any.whl:
Publisher:
publish.yml on kangkangzi2025/mnvitop
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mnvitop-1.0.0-py3-none-any.whl -
Subject digest:
0998ce5f8964f95c1ecff19f3f02874fa3352b9e4ac9163f164eba9f2d61a307 - Sigstore transparency entry: 2779030747
- Sigstore integration time:
-
Permalink:
kangkangzi2025/mnvitop@488578eccd96766209997961af0dc62cbb4f3e47 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/kangkangzi2025
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@488578eccd96766209997961af0dc62cbb4f3e47 -
Trigger Event:
push
-
Statement type:
