Metadata-Version: 2.1
Name: slurm-to-wandb
Version: 0.1.1
Summary: Uploads SLURM job information to WandB for better monitoring.
Home-page: https://github.com/dunnkers/slurm-to-wandb
Author: Jeroen Overschie
License: MIT
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: pandas (>=1.2)
Requires-Dist: wandb (>=0.10)
Requires-Dist: numpy (>=1.19)
Requires-Dist: humanfriendly (==9.1)

# slurm-to-wandb
[![build status](https://github.com/dunnkers/slurm-to-wandb/actions/workflows/python-app.yml/badge.svg)](https://github.com/dunnkers/slurm-to-wandb/actions/workflows/python-app.yml) [![pypi badge](https://img.shields.io/pypi/v/slurm-to-wandb.svg?maxAge=3600)](https://pypi.org/project/slurm-to-wandb/)

 Monitor SLURM jobs using Weights and Biases (wandb) 📊

## Usage
On your cluster, login to wandb using the [cli](https://github.com/wandb/client), then run:

```shell
pip install slurm-to-wandb
slurm_to_wandb <job_ids>
```

... to upload all `sacct` information to wandb. `<job_ids>` can be multiple space-separated job ids. In the case multiple job id's match, all matched job ids are uploaded (useful, for example, when using job arrays).

To construct a DataFrame with the information yourself, run on the cluster:

```python
from slurm_to_wandb import sacct_as_df

df = sacct_as_df(*<job_ids>)
df
```

You can now upload the information to wandb however you like 🙌🏻

## About
By [Jeroen Overschie](https://dunnkers.com/).

