slrun 0.1.0

Run commands on SLURM as if local with seamless detach/reattach

slrun - SLURM Tools

Run commands on SLURM as if they were local, with seamless detach/reattach capabilities.

Features

• Seamless job submission: Run commands on SLURM with minimal syntax changes
• Real-time output streaming: See stdout/stderr as if running locally
• Detach/reattach capability: Start a job, detach, and reconnect later
• Job management: List all detached jobs and their statuses
• Automatic cleanup: Temporary files are removed when jobs complete

Installation

Using UV (recommended)

uv pip install slrun

Directly from GitHub

uv pip install git+https://github.com/yashsavani/slurm-tools.git

Using pip

pip install slrun

Quick Start

Launch a job

slrun launch python train_model.py --epochs 100

With custom SLURM resources

slrun launch --mem 128GB --time 2-00:00:00 --gres gpu:A100:2 python train_model.py

Handling argument conflicts

When your command uses arguments that might conflict with slrun, use the -- separator:

slrun launch --timeout 7200 -- python script.py --timeout 3600

List all detached jobs

slrun list

Reattach to a job

slrun attach 12345  # Replace with your job ID

Development

Local Development Setup

# Clone the repository
git clone https://github.com/yashsavani/slurm-tools.git
cd slurm-tools

# Install in development mode
uv pip install -e .

Building the Package

uv build

Documentation

For complete usage instructions, see the detailed documentation.

Requirements

• Python 3.6+
• Access to a SLURM cluster with sbatch, squeue, and sacct commands

License

MIT