Real-time GPU monitor for NVIDIA DGX Spark and other unified memory (UMA) systems
Project description
sparkstat
Real-time GPU monitoring for NVIDIA DGX Spark and other unified memory (UMA) systems.
sparkstat fills the gap left by nvidia-smi and gpustat on iGPU/UMA machines. On these platforms, nvidia-smi typically reports “Memory-Usage: Not Supported” because iGPUs do not have dedicated framebuffer memory. By combining GPU metrics with /proc/meminfo, sparkstat shows memory that is actually available to GPU workloads.
Requirements
- Linux
- Python 3.9+
- NVIDIA driver with
nvidia-smi
Install
pip install sparkstat
pipx install sparkstat
uv tool install sparkstat
curl -fsSL https://raw.githubusercontent.com/kooyunmo/sparkstat/main/install.sh | sh
Usage
sparkstat # Single snapshot
sparkstat -i # Watch mode (3s interval)
sparkstat -i 1 # Watch mode (1s interval)
sparkstat --no-proc # Hide process list
Example output
spark-838f Fri Apr 10 01:05:26 2026 NVIDIA GB10
═════════════════════════════════════════════════════════
DGX Spark · 121.7GiB Unified Memory (UMA)
───────────────────────────────────────────────────────
DRAM [█████░░░░░] 53.8% 65.5GiB / 121.7GiB
Avail 69.3GiB (DRAM: 56.2GiB + Swap free: 13.1GiB)
Swap [█░░░░░░░░░] 18.1% 2.9GiB / 16.0GiB
───────────────────────────────────────────────────────
GPU NVIDIA GB10
Util GPU 2% │ Alloc 51% │ Temp 46°C
Pwr 13.2W │ Clk 2411MHz │ P-State P0
───────────────────────────────────────────────────────
Processes (1 active, 62.2GiB GPU alloc)
62928 VLLM::EngineCore 62.2GiB
═════════════════════════════════════════════════════════
What it shows
- DRAM and swap usage
- Effective available memory for GPU workloads
- GPU utilization, temperature, power, clock, and P-State
- Per-process GPU allocation
License
MIT
Project details
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
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 sparkstat-0.1.1.tar.gz.
File metadata
- Download URL: sparkstat-0.1.1.tar.gz
- Upload date:
- Size: 7.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bc1aadf8fa3f572142d93f84c106212eee9b5fc109cd10e9d155e34d8e14d375
|
|
| MD5 |
1cd3c12a1671408a66001efefaa4be8d
|
|
| BLAKE2b-256 |
e8e1d030f402ce1019b780b5fbe4431aa0b0d2f98e9e23161798aa634a69d1c1
|
Provenance
The following attestation bundles were made for sparkstat-0.1.1.tar.gz:
Publisher:
publish.yml on kooyunmo/sparkstat
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sparkstat-0.1.1.tar.gz -
Subject digest:
bc1aadf8fa3f572142d93f84c106212eee9b5fc109cd10e9d155e34d8e14d375 - Sigstore transparency entry: 1282904046
- Sigstore integration time:
-
Permalink:
kooyunmo/sparkstat@42ff37b2b905bf4502893cc8860fa80c3f330a77 -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/kooyunmo
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@42ff37b2b905bf4502893cc8860fa80c3f330a77 -
Trigger Event:
push
-
Statement type:
File details
Details for the file sparkstat-0.1.1-py3-none-any.whl.
File metadata
- Download URL: sparkstat-0.1.1-py3-none-any.whl
- Upload date:
- Size: 7.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0b8ef966507ac7b5adfb5b106582822333929416ed1c1d6f53c5fd7c683e264e
|
|
| MD5 |
50dad8379a41ea7c7bf7124682cc51a6
|
|
| BLAKE2b-256 |
3cf93e06c150cc3bd3ead4f577bb0b008ab920257d69fd7e12d8ef18c880352d
|
Provenance
The following attestation bundles were made for sparkstat-0.1.1-py3-none-any.whl:
Publisher:
publish.yml on kooyunmo/sparkstat
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sparkstat-0.1.1-py3-none-any.whl -
Subject digest:
0b8ef966507ac7b5adfb5b106582822333929416ed1c1d6f53c5fd7c683e264e - Sigstore transparency entry: 1282904050
- Sigstore integration time:
-
Permalink:
kooyunmo/sparkstat@42ff37b2b905bf4502893cc8860fa80c3f330a77 -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/kooyunmo
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@42ff37b2b905bf4502893cc8860fa80c3f330a77 -
Trigger Event:
push
-
Statement type: