https://github.com/brontoguana/ktop
Terminal system resource monitor for hybrid LLM workloads
https://github.com/brontoguana/ktop
btop-alternative cli gpu-monitoring htop-alternative llm monitoring nvidia python resource-monitor system-monitor terminal tui
Last synced: 2 months ago
JSON representation
Terminal system resource monitor for hybrid LLM workloads
- Host: GitHub
- URL: https://github.com/brontoguana/ktop
- Owner: brontoguana
- Created: 2026-02-10T09:42:40.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-03-22T22:05:54.000Z (3 months ago)
- Last Synced: 2026-03-23T12:38:04.389Z (3 months ago)
- Topics: btop-alternative, cli, gpu-monitoring, htop-alternative, llm, monitoring, nvidia, python, resource-monitor, system-monitor, terminal, tui
- Language: Rust
- Size: 1.03 MB
- Stars: 69
- Watchers: 0
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# ktop
A terminal-based system resource monitor built for tracking resource usage when running hybrid LLM workloads.
## Features
### Latest
- Rewritten from Python to Rust — single static binary, near-zero CPU overhead, instant startup
- One-line install and upgrade: `curl -sSfL https://raw.githubusercontent.com/brontoguana/ktop/master/install.sh | bash`
- No runtime dependencies — no Python, no pip, no venv
### Core
- **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
```bash
curl -sSfL https://raw.githubusercontent.com/brontoguana/ktop/master/install.sh | bash
```
Downloads the latest binary and installs it to `/usr/local/bin` (will prompt for sudo if needed). Run the same command again to upgrade.
### Build from source
```bash
git clone https://github.com/brontoguana/ktop.git
cd ktop/ktop-rs
cargo build --release
sudo cp target/release/ktop /usr/local/bin/
```
## Usage
```bash
# 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
| Key | Action |
|-----|--------|
| `q` / `ESC` | Quit |
| `t` | Open theme picker |
| Arrow keys | Navigate theme picker |
| `Enter` | Select theme |
## Requirements
- Linux (reads `/proc` and sysfs directly)
- NVIDIA GPU + drivers (optional — for NVIDIA monitoring)
- AMD GPU + `amdgpu` driver (optional — for AMD monitoring)
- No runtime dependencies — single static binary
## License
MIT