nvidia-smi-style TPU monitor CLI
Project description
google-smi
google-smi is a TPU-oriented status CLI in the style of nvidia-smi. It shows per-device HBM usage, TPU utilization, PCIe / NUMA / IOMMU context, and process attribution for local TPU VMs.
Thu Mar 12 01:58:21 2026
+---------------------------------------------------------------------------------------+
| Google-SMI 0.1.0 Driver: vfio-pci libtpu Version: 0.0.17 |
|-------------------------------------+--------------------------+----------------------|
| TPU Name NUMA Node | Bus-Id IOMMU | PCIe |
| | Memory-Usage | TPU-Util |
|=====================================+==========================+======================|
| 0 TPU v6e 0 | 0000:00:04.0 0 | x0 |
| | 406MiB / 31995MiB | 0.0% |
+-------------------------------------+--------------------------+----------------------+
| 1 TPU v6e 0 | 0000:00:05.0 1 | x0 |
| | 406MiB / 31995MiB | 0.0% |
+-------------------------------------+--------------------------+----------------------+
...
| Processes: |
| TPU PID Type Process Name Memory Usage |
|=======================================================================================|
| 0 2955029 C python 406MiB |
+---------------------------------------------------------------------------------------+
Install
pip install git+https://github.com/bzantium/google-smi.git
Quick Start
# default table view
google-smi
# show Bus-Id / IOMMU detail columns
google-smi -d
# refresh in place every second
google-smi -i
# refresh every 0.5 seconds
google-smi -i 0.5
# machine-readable output
google-smi --json
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
google_smi-0.1.0.tar.gz
(22.5 kB
view details)
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 google_smi-0.1.0.tar.gz.
File metadata
- Download URL: google_smi-0.1.0.tar.gz
- Upload date:
- Size: 22.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d0f23916e895d7f29282f70a600f089d3662ecc5e26dc64fd76c1957f907f472
|
|
| MD5 |
cc3b4f1b721a00cad3c47500ce8314d1
|
|
| BLAKE2b-256 |
0df13e1b93c9edf04c0fbd4ccc71a20661946a21b57d487fe5daf15795f6ba1c
|
File details
Details for the file google_smi-0.1.0-py3-none-any.whl.
File metadata
- Download URL: google_smi-0.1.0-py3-none-any.whl
- Upload date:
- Size: 28.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
015a511a445998b73de2ed8995d4ad55fc841ab878c3c6f4a30ff48d4c1e8c2d
|
|
| MD5 |
05582a9ff3b8feb0f39861dc39d5f3e0
|
|
| BLAKE2b-256 |
1b20cdf781d63409afc6100c8863753fc2713b49327059bffa585fd3b3dd58ea
|
