slurm-usage

library3.1.0pypypi✓ verified 83d ago

slurm-usage (v3.1.0) is a command-line tool that displays current Slurm cluster usage per user, including job counts, CPU cores, memory, and GPU resources. It helps cluster administrators monitor usage. Release cadence is irregular; last stable release 3.1.0 (2024). Requires Python >=3.10.

devops

pip install slurm-usage

github ↗homepage ↗

INSTALL

IMPORT

SIG · SLURM-USAGE

slurm-usage

devopspythonv3.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

slurm_usage

✓ import slurm_usage

Used as a CLI script; no public API modules are exported.

Basic usage of slurm-usage as a Python module (CLI).

import os import slurm_usage # slurm-usage is primarily a CLI tool. Run with: python -m slurm_usage os.system("python -m slurm_usage")

Debug

Known issues

deprecatedslurm-usage v3.0 dropped Python 2.7 support; v3.1 requires Python >=3.10.

fix

Upgrade Python to >=3.10 and install slurm-usage>=3.1.0.

affects: <3.0.0

gotchaslurm-usage is mainly a CLI tool; importing it as a library does not expose a public API. Attempting to import 'slurm_usage' will import an empty namespace.

fix

Use it via command line: `slurm-usage` or `python -m slurm_usage`.

affects: all

gotchaIf Slurm commands (sacct, sinfo, squeue) are not available or not configured, the tool will fail with non-descriptive errors.

fix

Ensure Slurm environment is properly set up and commands are in PATH.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'slurm_usage'

Trying to import 'slurm_usage' as a Python package, but it has no public API.

fix

Run as CLI: `slurm-usage` or `python -m slurm_usage`.

slurm-usage: command not found

The pip-installed script is not in PATH or the package is not installed correctly.

fix

Install with pip: `pip install slurm-usage` and verify with `pip show slurm-usage`. Add `~/.local/bin` to PATH if necessary.

Upgrade

Version history

3.1.0latest on PyPI · released Sep 22, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

14 hits · last 30 days

node

Resources

githubhttps://github.com/basnijholt/slurm-usage ↗

homepagehttps://github.com/basnijholt/slurm-usage ↗