GitHub - brontoguana/ktop: Terminal system resource monitor for hybrid LLM workloads

ktop

A terminal-based system resource monitor built for tracking resource usage when running hybrid LLM workloads.

Features

• GPU Monitoring — Per-GPU utilization and memory usage with color-coded sparkline history (NVIDIA + AMD)
• Network Monitoring — Upload/download speeds with separate colored sparklines (upload extends up, download extends down)
• CPU Monitoring — Overall CPU usage with gradient bar chart and sparkline history
• Memory Monitoring — RAM and swap usage with gradient progress bars
• Temperature Strip — CPU, memory, and per-GPU temps with mini bar charts and hardware-accurate thresholds
• OOM Kill Tracker — Status bar shows the most recent OOM kill from the last 8 hours (kernel OOM and systemd-oomd)
• Process Tables — Top 10 processes by memory (Used/Shared) and CPU usage (Core % + system-wide CPU %)
• 50 Color Themes — Press t to browse and switch themes with live preview; persists across sessions
• Gradient Bar Charts — Smooth per-block color gradients from low to high across all bars
• Responsive UI — 50ms input polling for snappy keyboard navigation

Install

git clone https://github.com/brontoguana/ktop.git && cd ktop && ./setup.sh

That's it — clones the repo, installs dependencies into a venv, adds ktop to ~/.local/bin, and launches it.

For a system-wide install: sudo ./setup.sh --system

Usage

# Run with defaults (1s refresh)
ktop

# Custom refresh rate
ktop -r 2

# Start with a specific theme
ktop --theme "Tokyo Night"

# Simulation mode (fake OOM kills, profiling to /tmp/ktop_profile.log)
ktop --sim

# Show version
ktop --version

Keybindings

Requirements

• Linux (reads /proc directly for performance)
• Python 3.8+
• NVIDIA GPU + drivers (optional — pynvml for NVIDIA monitoring)
• AMD GPU + amdgpu driver (optional — uses sysfs, no extra dependencies)
• Dependencies: psutil, rich, nvidia-ml-py or pynvml (optional, for NVIDIA)

License

MIT