{"id":46398,"library":"slurm-usage","title":"slurm-usage","description":"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.","status":"active","version":"3.1.0","language":"python","source_language":"en","source_url":"https://github.com/basnijholt/slurm-usage","tags":["slurm","hpc","cluster","usage"],"install":[{"cmd":"pip install slurm-usage","lang":"bash","label":"Default install"}],"dependencies":[],"imports":[{"note":"Used as a CLI script; no public API modules are exported.","symbol":"slurm_usage","correct":"import slurm_usage"}],"quickstart":{"code":"import os\nimport slurm_usage\n# slurm-usage is primarily a CLI tool. Run with: python -m slurm_usage\nos.system(\"python -m slurm_usage\")","lang":"python","description":"Basic usage of slurm-usage as a Python module (CLI)."},"warnings":[{"fix":"Upgrade Python to >=3.10 and install slurm-usage>=3.1.0.","message":"slurm-usage v3.0 dropped Python 2.7 support; v3.1 requires Python >=3.10.","severity":"deprecated","affected_versions":"<3.0.0"},{"fix":"Use it via command line: `slurm-usage` or `python -m slurm_usage`.","message":"slurm-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.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure Slurm environment is properly set up and commands are in PATH.","message":"If Slurm commands (sacct, sinfo, squeue) are not available or not configured, the tool will fail with non-descriptive errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'2024':45 '3.1.0':44 '3.10':48 'administr':34 'cadenc':38 'cluster':18,33,51 'command':11 'command-lin':10 'core':26 'count':24 'cpu':25 'current':16 'display':15 'gpu':29 'help':32 'hpc':50 'includ':22 'irregular':40 'job':23 'last':41 'line':12 'memori':27 'monitor':35 'per':20 'python':47 'releas':37,43 'requir':46 'resourc':30 'slurm':2,5,17,49 'slurm-usag':1,4 'stabl':42 'tool':13 'usag':3,6,19,36,52 'user':21 'v3.1.0':7","created_at":"2026-06-07T12:59:44.255793+00:00","updated_at":"2026-06-07T12:59:44.255793+00:00","problems":[{"fix":"Run as CLI: `slurm-usage` or `python -m slurm_usage`.","cause":"Trying to import 'slurm_usage' as a Python package, but it has no public API.","error":"ModuleNotFoundError: No module named 'slurm_usage'"},{"fix":"Install with pip: `pip install slurm-usage` and verify with `pip show slurm-usage`. Add `~/.local/bin` to PATH if necessary.","cause":"The pip-installed script is not in PATH or the package is not installed correctly.","error":"slurm-usage: command not found"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/basnijholt/slurm-usage","github":"https://github.com/basnijholt/slurm-usage","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}