v1.0.0

roctop v1.0.0

The first official stable release of roctop—a lightweight, keyboard-driven terminal monitor for AMD ROCm GPUs.

Highlights

• Live Rich terminal interface for GPU health, utilization, temperature, power, clocks, and VRAM usage.
• Host and GPU history graphs.
• Detailed GPU process table with CPU, memory, runtime, command, and container information.
• Process search, filtering, sorting, tree navigation, inspection, and safe termination flows.
• Per-GPU focus and responsive layouts for different terminal sizes.
• Scriptable --once and --json output modes.
• Data collection through rocm-smi, with optional amd-smi enrichment.
• Graceful handling of missing, malformed, or partial ROCm data.

Stability and safety

This release includes extensive hardening for:

• Multi-GPU process reporting.
• Malformed and non-finite metric values.
• Terminal escape and Rich markup injection.
• Deep process trees and fragmented UTF-8 keyboard input.
• Terminal restoration during SIGHUP, SIGTERM, and SIGQUIT.
• Help scrolling and narrow-terminal rendering.
• Packaging and installed-wheel verification.

The release was validated with 268 tests across Python 3.10–3.12 and Rich 13–15.

Installation

pip install roctop

Then start the live monitor:

roctop

Python 3.10 or newer and rocm-smi are required. amd-smi is optional.

Thank you to everyone trying the first stable release. Bug reports and contributions are welcome.

Full changelog: v0.4.4...v1.0.0

v0.4.4

roctop v0.4.4

Release này gom các cải thiện inspect container/K8s và một vài fix UI quan trọng.

Highlights

• Inspect popup hiển thị Docker/containerd/K8s metadata cho process trong container, gồm namespace khi lấy được.
• Focus mode + tree lọc process con/sibling đúng theo GPU đang focus.

Fixes

• Memory Free color scale đã đúng chiều: free nhiều xanh, free ít đỏ.

Full Changelog

v0.4.3...v0.4.4

v0.4.3

roctop v0.4.3

Focus mode now shows PCIe link and throughput details while keeping process details in the process table.

Highlights

• Show PCIe link speed/width and PCIe throughput in GPU focus.
• Keep GPU focus focused on device metrics by removing process summary rows.

Full Changelog

v0.4.2...v0.4.3

v0.4.2

roctop v0.4.2

This release improves long-running live graph stability and polishes the GPU table display.

Highlights

• GPU table columns now align consistently for easier scanning.
• GPU graph frame updates now step one second at a time instead of jumping multiple columns after render gaps.
• Help popup wrapping and GPU graph exit handling were tightened.

Fixes

• Improved live monitor resilience against transient collector, terminal, and render failures.
• Fixed graph behavior seen during long roctop sessions.

Full Changelog

v0.4.1...v0.4.2

v0.4.1

roctop v0.4.1

roctop v0.4.1 improves interactive process management and makes the help and focused GPU views easier to scan.

Highlights

• Select multiple process PIDs with Space, then apply the existing safe kill confirmation flow to all selected processes at once.
• Show selected process rows with a subtle cyan background, and use Esc to clear selected processes before clearing filters.
• Redesign the in-app help popup into grouped, responsive sections with clearer keybinding guidance.
• Reorder focused GPU metrics so utilization, memory pressure, power, clocks, and top process details are easier to read first.

Full Changelog

v0.4.0...v0.4.1

v0.4.0

roctop v0.4.0

This release expands the focused GPU view and refines the GPU focus graph experience.

Highlights

• Expanded focused GPU metrics with richer hardware and process details.
• Added and refined GPU focus graph views.
• Kept parent process context visible in tree mode while focused on a GPU.

Fixes

• Removed throttle status from the focused GPU metric panel.

Full Changelog

v0.3.4...v0.4.0

v0.3.4

roctop v0.3.4

This release improves the stability and readability of the live terminal UI, with a focus on graph history behavior and process table layout.

Highlights

• Added a fixed 18-minute graph history window with one-second graph updates.
• Kept graph history uncompressed so time markers remain consistent across terminal widths.
• Improved graph panning and clamped history rendering to the 1080-second window.
• Fixed long-window time labels, including 1080s, disappearing at the left edge of a graph.
• Made process elapsed time tick forward once per second between collector refreshes.
• Stabilized process table column widths to reduce layout jitter.
• Improved truncated process row rendering so the table fills available terminal space more cleanly.
• Stabilized inspect popup columns for long process metadata.

Fixes

• Fixed graph time-axis labels being dropped when one graph column was one character narrower than the other.
• Prevented graph data from drawing before the visible history limit marker.
• Improved elapsed-time parsing and rendering for process rows.
• Reduced UI shifting in process and inspect views.

Full Changelog

v0.3.3...v0.3.4

v0.3.3

roctop v0.3.3

Packaging and PyPI

• Added PyPI project URLs for the GitHub homepage, repository, and issue tracker.
• Updated the README install section to prefer pip install roctop.
• Rewrote the source install instructions to use a normal git clone checkout instead of direct pip install git+....
• Updated the README demo image URL for the v0.3.3 tag.

Verification

• Test suite passes: 167 tests.
• CLI version reports roctop 0.3.3.

v0.3.2

roctop v0.3.2

Fixes

• Fixed the broken demo image on the PyPI project page by using an absolute GitHub raw URL instead of the repository-relative docs/demo.svg path.
• Improved Esc behavior in process zoom mode: active text/GPU filters are cleared first, and a second Esc exits zoom.

Packaging

• Bumped package version to 0.3.2.
• Rebuilt PyPI distributions for 0.3.2.

Verification

• Test suite passes: 167 tests.
• twine check passes for both:
  • roctop-0.3.2.tar.gz
  • roctop-0.3.2-py3-none-any.whl

v0.3.1

roctop v0.3.1

Highlights

• Added GPU number filtering, so you can quickly focus the UI on selected GPUs.
• Added process table zoom for easier inspection of long process lists.
• Added graph history panning for navigating recent metric history.
• Improved live graph rendering stability, including subsecond refresh behavior and keypress-driven redraws.
• Fixed process info popup overflow handling.
• Improved process safety and telemetry parsing around malformed or incomplete ROCm/AMD SMI process data.

Packaging and Release

• Added GitHub Actions workflow to build Python distributions and publish to PyPI.
• Refreshed the demo SVG with the current UI controls.
• Bumped package version to 0.3.1.

Verification

• Test coverage was updated across CLI, collectors, interaction, and rendering behavior.
• Local test suite passes with 166 tests.