Skip to main content

A sleek, modern job monitoring tool for Slurm workload manager

Project description

🎯 SWATCH (Slurm Watch)

A sleek, modern job monitoring tool for Slurm workload manager that doesn't make you want to pull your hair out!

SWATCH GUI

🌟 Features

  • 🎨 Beautiful dark theme interface
  • 🔄 Real-time job status monitoring
  • 🔐 Secure SSH authentication
  • 🎯 Status-based color coding
  • ⚡ Configurable auto-refresh
  • 🎮 Drag-and-drop window movement
  • 🧪 Test mode for demos and development

🚀 Quick Start

🎮 Command Line Options

Flag Description Example
-h, --help Show help message and exit python slurm_watch.py --help
-t, --test Run in test mode with sample data python slurm_watch.py --test

🎯 Job Status Colors

Status Color Description
🟢 Running Soft Green Job is actively running
🟡 Pending Soft Orange Job is waiting in queue
🔵 Completed Soft Blue Job finished successfully
🔴 Failed Soft Red Job failed or timed out

⚙️ Configuration

SWATCH automatically saves your configuration in ~/.hpcjobmonitor/config.json. You can:

  • 💾 Save login credentials (optional)
  • ⏰ Set refresh intervals:
    • 5 seconds
    • 30 seconds
    • 1 minute
    • 5 minutes
    • 10 minutes
    • 30 minutes

🔒 Security Note

When saving credentials, passwords are stored locally. For enhanced security:

  • 🚫 Don't save credentials on shared machines
  • ✅ Use SSH keys when possible
  • 🔑 Ensure ~/.hpcjobmonitor has appropriate permissions

🎨 Interface Features

  • 🖱️ Draggable window (click and drag title bar)
  • 📊 Sortable job columns
  • 🎯 Status indicators
  • 📈 Job statistics summary
  • ⏱️ Auto-refresh toggle

🤝 Contributing

Found a bug? Want to add a feature? We'd love your help!

  1. 🍴 Fork the repository
  2. 🌿 Create your feature branch
  3. 💾 Commit your changes
  4. 📤 Push to the branch
  5. 🎯 Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🎉 Fun Facts

  • The name "SWATCH" comes from "Slurm Watch" (not the watch company! 😉)

🐛 Known Issues

Remember: Happy monitoring! 🚀

📦 Installation

Using pip

pip install swatch-slurm

Using conda

conda install -c conda-forge swatch-slurm

Development Installation

git clone https://github.com/yourusername/swatch.git
cd swatch
pip install -e ".[dev]"

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swatch_slurm-0.1.0.tar.gz (29.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

swatch_slurm-0.1.0-py3-none-any.whl (14.5 kB view details)

Uploaded Python 3

File details

Details for the file swatch_slurm-0.1.0.tar.gz.

File metadata

  • Download URL: swatch_slurm-0.1.0.tar.gz
  • Upload date:
  • Size: 29.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.2

File hashes

Hashes for swatch_slurm-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0c97b834fad32fdf2d37486f3fc6666b418616a40b3562b42ce7806ddcb32a29
MD5 385373898f0694b596b0e4d7d4a78849
BLAKE2b-256 04b16043497770b18fc60aba7cee7c571ace6eb486da758ec9d9ab940e6d4cda

See more details on using hashes here.

File details

Details for the file swatch_slurm-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: swatch_slurm-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 14.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.2

File hashes

Hashes for swatch_slurm-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1fa661aa85cea9a75eff69d3bc7c72e7448a2b6749467edb256e3a63e9c74bb5
MD5 5756994a9cbb8bdef33cdc2fc493c09b
BLAKE2b-256 d109efc0a6f1b09caa97ea7d4a93573d4c17b6039189292a1d5d559e97222625

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page