A terminal UI for slurm job management. Like the awesome lazygit but for HPC clusters.
Slurm's CLI is powerful but clunky for monitoring. This project gives you the lazygit experience. Built in Rust with ratatui because single binaries are beautiful on HPC systems.
- Job management - Cancel jobs, view details, and monitor resource usage
- Single binary - No dependencies, perfect for HPC environments
- Real-time job monitoring - Watch your jobs as they run, with live log tailing
Download the latest binary for your platform from GitHub Releases:
# Linux x64
curl -L https://github.com/hill/lazyslurm/releases/latest/download/lazyslurm-linux-x64.tar.gz | tar xz
sudo mv lazyslurm /usr/local/bin/
# macOS (Apple Silicon)
curl -L https://github.com/hill/lazyslurm/releases/latest/download/lazyslurm-macos-arm64.tar.gz | tar xz
sudo mv lazyslurm /usr/local/bin/
# macOS (Intel)
curl -L https://github.com/hill/lazyslurm/releases/latest/download/lazyslurm-macos-x64.tar.gz | tar xz
sudo mv lazyslurm /usr/local/bin/brew install hill/tap/lazyslurmIf you have Rust installed:
cargo install lazyslurmgah install hill/lazyslurm# Monitor all jobs for current user
lazyslurm
# Monitor jobs for specific user
lazyslurm --user username
# Monitor jobs in specific partition
lazyslurm --partition gpu| Key | Context | Action |
|---|---|---|
q or Ctrl+C |
Normal | Exit application |
r |
Normal | Refresh jobs |
↑/↓ |
Normal | Navigate job list |
u |
Normal | Open user search popup |
p |
Normal | Open partition search popup |
c |
Normal | Open cancel job popup (if job selected) |
Enter |
SearchPopup | Confirm user input |
Esc |
SearchPopup | Cancel user input |
Char(c) |
SearchPopup | Append to input |
Backspace |
SearchPopup | Delete last input char |
y |
CancelJobPopup | Confirm job cancel |
n or Esc |
CancelJobPopup | Cancel job cancel |
LazySlurm reads configuration from ~/.config/lazyslurm/config.toml:
[display]
refresh_interval = 5 # seconds
max_log_lines = 100
[slurm]
default_user = "myusername"
default_partition = "compute"Requires Docker and just.
# Start SLURM container
just slurm_up
# Get into container for development
just slurm_shell
# Inside container: your code is at /workspace
cargo run
# Submit test jobs (from host or container)
just slurm_populateYour source code is mounted into the container so changes are immediately available.