Skip to main content

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

Metadata

Release files for google-smi 0.1.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 google-smi 0.1.0
File Size Uploaded Provenance
google_smi-0.1.0.tar.gz 22.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for google-smi 0.1.0
File Interpreter ABI Platform
google_smi-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 50.7 kB

Release files / google_smi-0.1.0.tar.gz

Download URL google_smi-0.1.0.tar.gz
Size 22.5 kB
Tags Source
SHA-256 checksum
How to use checksums
d0f23916e895d7f29282f70a600f089d3662ecc5e26dc64fd76c1957f907f472
BLAKE2b-256 checksum
How to use checksums
0df13e1b93c9edf04c0fbd4ccc71a20661946a21b57d487fe5daf15795f6ba1c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.12

Release files / google_smi-0.1.0-py3-none-any.whl

Download URL google_smi-0.1.0-py3-none-any.whl
Size 28.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
015a511a445998b73de2ed8995d4ad55fc841ab878c3c6f4a30ff48d4c1e8c2d
BLAKE2b-256 checksum
How to use checksums
1b20cdf781d63409afc6100c8863753fc2713b49327059bffa585fd3b3dd58ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.12

Security for google-smi 0.1.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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

0.1.0 This release

2 release files No 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