Skip to main content

nvidia-smi equivalent for Apple Silicon — real-time GPU/CPU/RAM monitor

Project description

macos-smi

nvidia-smi equivalent for Apple Silicon — real-time GPU/CPU/RAM monitor for anyone running LLM inference (MLX, llama.cpp, Ollama, etc.) on a MacBook.

╔══════════════════════════════════════════════════════════════════════╗
║  macos-smi                              Sun Apr 12 10:15:30 2026    ║
║  Apple M4 Pro  ·  64 GB unified memory                              ║
╠═══════════════════════════════╦══════════════════════════════════════╣
║  GPU                          ║  Memory (Unified)                    ║
║  Utilization :  73 %          ║  Used    :  24.3 GB                  ║
║  Power       :  18.2 W        ║  Total   :  64.0 GB  (38 %)          ║
╠═══════════════════════════════╬══════════════════════════════════════╣
║  CPU                          ║                                      ║
║  Utilization :  42 %          ║                                      ║
║  Power       :   8.4 W        ║                                      ║
╚═══════════════════════════════╩══════════════════════════════════════╝
  Ctrl-C to quit  ·  1 Hz  ·  local powermetrics

Install

# Using uv (recommended)
uv tool install macos-smi

# Using pip
pip3 install macos-smi

# From source
git clone https://github.com/tianszz/macos-smi.git
cd macos-smi && uv tool install .

Usage

# CPU + RAM only (no sudo required)
macos-smi

# Full stats including GPU utilization and power draw
sudo macos-smi

# Single snapshot and exit (like nvidia-smi default)
sudo macos-smi --no-loop

# Faster refresh
sudo macos-smi --interval 500

Requirements

  • macOS on Apple Silicon (M1 / M2 / M3 / M4)
  • sudo access for GPU stats via powermetrics (CPU + RAM work without sudo)

How it works

GPU utilization and power draw are read from Apple's powermetrics utility (requires root). CPU utilization and RAM are read via psutil (no sudo needed). The display updates at 1 Hz by default using Rich.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

macos_smi-0.1.0.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

macos_smi-0.1.0-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file macos_smi-0.1.0.tar.gz.

File metadata

  • Download URL: macos_smi-0.1.0.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for macos_smi-0.1.0.tar.gz
Algorithm Hash digest
SHA256 193004342458a75cd8fbe8241737061adb379d59cae676e0567ad951e341e302
MD5 4a95a6eb3a2735315fa77b43bf8dae59
BLAKE2b-256 730bc6d8a49d39dd6e94a566a9e743ce5740e2d2f63df604257a60afc266e5f0

See more details on using hashes here.

File details

Details for the file macos_smi-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: macos_smi-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for macos_smi-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a828c15d70d710ca3b4029fe1248566d07b6e5759beddd8235838e75f29fcdc4
MD5 57eeed87289698153a82e1fe2b1404d8
BLAKE2b-256 40d714a48fe8af074ea5488706dcb8c2f4e6d24f52c429d4840c72e12bb16956

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page