gpulegion 0.1.1

Unified GPU telemetry for Apple Silicon, NVIDIA, and beyond

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:

Tool	Apple Silicon	NVIDIA	Programmatic API
GPUtil	❌	✅	✅
gputop	❌	✅	⚠️ (CLI-first)
gpulegion	✅	✅	✅

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