gpulegion

Unified GPU telemetry for Apple Silicon, NVIDIA, and beyond.

Why gpulegion?

Existing Python GPU monitoring tools like GPUtil only support NVIDIA GPUs. If you're developing on Apple Silicon (M1-M5), you're out of luck.

gpulegion fills that gap with a simple, cross-platform API:

Installation

pip install gpulegion

Quick Start

import gpulegion as gl

# Check if GPU monitoring is available
if gl.is_available():
    print(f"GPU Usage: {gl.usage()}%")
    print(f"GPU Power: {gl.power()}W")
    print(f"Device: {gl.device()}")
else:
    print("No GPU detected")

API Reference

Core Functions

• backends() → List of available backend names
• is_available() → True if GPU monitoring is supported
• usage() → GPU utilization percentage (0-100) or None
• power() → GPU power consumption in watts or None
• memory() → Dict with used_mb and total_mb or None
• device() → Dict with vendor, model, and device info or None

Design Philosophy

• Never crash: Returns None when data unavailable
• Minimal dependencies: No heavy ML frameworks required
• Cross-platform: Works on macOS (Apple Silicon), Linux (NVIDIA), and gracefully degrades elsewhere

Platform Support

Apple Silicon (M1-M5)

Requires passwordless sudo access to powermetrics:

# Add to /etc/sudoers.d/powermetrics
your_username ALL=(ALL) NOPASSWD: /usr/bin/powermetrics

NVIDIA

Requires nvidia-smi (comes with NVIDIA drivers).

Example Output

>>> import gpulegion as gl
>>> gl.device()
{'vendor': 'Apple', 'model': 'Apple M2 Pro', 'arch': 'arm64'}

>>> gl.usage()
34.2

>>> gl.power()
12.8

Roadmap

• Apple Silicon support
• NVIDIA support
• AMD support
• Intel discrete GPU support
• Multi-GPU support
• CLI tool

Contributing

Contributions welcome! This library is intentionally minimal - we prioritize reliability over features.

License

MIT