slurmwatch
Live per-process CPU / memory / GPU telemetry for a running Slurm job — the facts, so you can judge.
See whether your running job is actually using the CPU, memory, and GPUs you requested — live, in your terminal.
Install
pip install slurmwatch # or: uv tool install slurmwatch / pipx install slurmwatch
Python 3.10+ on Linux (cgroup v1/v2). GPU monitoring auto-activates on NVIDIA nodes, and is skipped on CPU-only ones.
Usage
slurmwatch 12345 # watch a specific job
slurmwatch # or auto-discover your running job
sw 12345 # "sw" is a short alias
slurmwatch --help # everything else
Keys — c/m/g drill into CPU / memory / GPU · type a node number (or ←/→) to switch node · p expand a truncated path · q back/quit.
It counts only your PIDs (a neighbour on a shared node never inflates your numbers), tracks the real working set against your --mem, and flags an idle GPU that's still holding VRAM — the stuff nvidia-smi and htop won't tell you about your job.
Point it at a pending job and, instead of an error, you get why it's waiting, when it'll start and where you sit in line, and where it could run right now — with the exact scontrol update to requeue into a partition that fits.
Run it from a login node or on the node itself — it attaches either way, and falls back to an sstat summary when it can't.
1 maintainer
Metadata
1 maintainer
Release files for slurmwatch 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| slurmwatch-1.2.0.tar.gz | 4.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| slurmwatch-1.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.7 MB
Release files / slurmwatch-1.2.0.tar.gz
| Download URL | slurmwatch-1.2.0.tar.gz |
|---|---|
| Size | 4.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a744fd53e901dc4cf6b9a18442405c5a280ff3beeddebc2785dc81bd331173ea
|
|
BLAKE2b-256 checksum How to use checksums |
0160dca4ce03e9a0e5d294dc33ffef071d0bba602193f40066b90eade699a19b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logRelease files / slurmwatch-1.2.0-py3-none-any.whl
| Download URL | slurmwatch-1.2.0-py3-none-any.whl |
|---|---|
| Size | 268.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1b6780e62816dfc3a52c69deece1cf424ef62cb6d9a222f5f2dc0b47baaaf89a
|
|
BLAKE2b-256 checksum How to use checksums |
f944af66bf1ef7af5841f8316c2ca16b8e4dcbf3ed8609d12f966f9d4e2f3ee7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency log
