roctop v0.1.0

roctop v0.1.0

Initial release of roctop, a lightweight Rich terminal monitor for AMD ROCm GPUs.

Highlights

• Live terminal UI for monitoring AMD ROCm GPU state.
• One-shot terminal rendering with --once.
• Normalized JSON output with --json for scripting and automation.
• Configurable refresh interval with --interval.

Features

• GPU overview table showing GPU index, DID, GUID, temperature, fan, power, SCLK/MCLK clocks, VRAM usage, and utilization.
• GPU type and GFX version summary in the header when available.
• Inline utilization bars for GPU memory and GPU activity, with color thresholds for low, medium, and high usage.
• Process table showing GPU index, PID, user, GPU memory, GPU memory percentage, host CPU/memory usage, elapsed time, and command.
• Data collection from rocm-smi, amd-smi process, and ps, with fallback behavior when process-specific data is unavailable.
• Warning panel for visible ROCm/tooling issues while hiding common noisy permission warnings.
• Truecolor Dracula-styled terminal rendering and demo SVG.

Reliability

• Retries transient command timeouts during live rendering.
• Handles missing commands and collection failures with clear error messages.
• Filters zero-memory GPU processes from process output.
• Keeps unsupported fan data visible as N/A instead of hiding the column.

Requirements

• Python 3.10+
• rich>=13
• ROCm tools available on the host, especially rocm-smi; amd-smi is used when available for process memory details.