rivanna.devgithub

getting started

rv is a CLI for running GPU jobs on UVA's Rivanna cluster. no SLURM scripts, no partition guessing — one command to submit.

1

install

run this in your terminal (macOS or Linux):

curl -fsSL https://rivanna.dev/install.sh | bash

installs to ~/.local/bin/rv. supports macOS (x86_64, arm64) and Linux (x86_64).

2

setup

run the interactive setup wizard:

rv init

this will ask for your UVA computing ID, check VPN connectivity, set up SSH keys, discover your Slurm account, and configure the remote environment. you need to be connected to the UVA Anywhere VPN to continue.

3

first job

try a free MIG GPU slice (no SU cost, instant allocation):

rv up --mig

or run a script in batch mode:

rv run python train.py

check your cluster status:

rv status

what's next?

  • commands — full reference for all 14 rv commands
  • smart allocator — how fan-out strategy and backfill detection work
  • configuration — config file, environment variables, notifications