pysqa
High-performance computing (HPC) does not have to be hard. In this context the aim of the Python Simple Queuing System
Adapter (pysqa) is to simplify the submission of tasks from python to HPC clusters as easy as starting another
subprocess locally. This is achieved based on the assumption that even though modern HPC queuing systems offer a wide
range of different configuration options, most users submit the majority of their jobs with very similar parameters.
Therefore, in pysqa users define submission script templates once and reuse them to submit many different tasks and
workflows afterwards. These templates are defined in the jinja2 template language,
so current submission scripts can be easily converted to templates. In addition, to the submission of new tasks to HPC
queuing systems, pysqa also allows the users to track the progress of their tasks, delete them or enable reservations
using the built-in functionality of the queuing system. Finally, pysqa enables remote connections to HPC clusters
using SSH including support for two factor authentication via pyauthenticator,
this allows the users to submit task from a python process on their local workstation to remote HPC clusters.
All this functionality is available from both the Python interface as well as the command line interface.
Features
The core feature of pysqa is the communication to HPC queuing systems including (Flux,
LSF, MOAB,
SGE, SLURM
and TORQUE). This includes:
QueueAdapter().submit_job()- Submission of new tasks to the queuing system.QueueAdapter().get_queue_status()- List of calculation currently waiting or running on the queuing system.QueueAdapter().delete_job()- Deleting calculation which are currently waiting or running on the queuing system.QueueAdapter().queue_list- List of available queue templates created by the user.QueueAdapter().config- Templates to a specific number of cores, run time or other computing resources. With integrated checks if a given submitted task follows these restrictions.
In addition to these core features, pysqa is continuously extended to support more use cases for a larger group of
users. These new features include the support for remote queuing systems:
- Remote connection via the secure shell protocol (SSH) to access remote HPC clusters.
- Transfer of files to and from remote HPC clusters, based on a predefined mapping of the remote file system into the local file system.
- Support for both individual connections as well as continuous connections depending on the network availability.
Finally, there is current work in progress to support a combination of multiple local and remote queuing systems
from within pysqa, which are represented to the user as a single resource.
Documentation
- Installation
- Queuing Systems
- Python Interface Dynamic
- Python Interface Config
- Command Line Interface
- Advanced Configuration
- Debugging
Contributing
Contributions are welcome! Please see the contribution guidelines for how to report issues, request features, seek support and submit code, and the code of conduct for our community standards. Bugs and feature requests are tracked on the issue tracker.
License
pysqa is released under the BSD license . It is a spin-off of the
pyiron project therefore if you use pysqa for calculation which result in a scientific
publication, please cite:
@article{pyiron-paper,
title = {pyiron: An integrated development environment for computational materials science},
journal = {Computational Materials Science},
volume = {163},
pages = {24 - 36},
year = {2019},
issn = {0927-0256},
doi = {https://doi.org/10.1016/j.commatsci.2018.07.043},
url = {http://www.sciencedirect.com/science/article/pii/S0927025618304786},
author = {Jan Janssen and Sudarsan Surendralal and Yury Lysogorskiy and Mira Todorova and Tilmann Hickel and Ralf Drautz and Jörg Neugebauer},
keywords = {Modelling workflow, Integrated development environment, Complex simulation protocols},
}
2 maintainers
Metadata
2 maintainers
Release files for pysqa 1.0.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 | |
|---|---|---|---|
| pysqa-1.0.0.tar.gz | 25.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pysqa-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 64.5 kB
Release files / pysqa-1.0.0.tar.gz
| Download URL | pysqa-1.0.0.tar.gz |
|---|---|
| Size | 25.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d7ca6177bb39cb0d321a00f529eaee15a2d062324d20386eb480cb2a415f19bd
|
|
BLAKE2b-256 checksum How to use checksums |
d22603df1becd0a956a90d3b35cc232c00c20b8bd9513693b1ef1ac321a9038e
|
| 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 31, 2026.
Transparency logRelease files / pysqa-1.0.0-py3-none-any.whl
| Download URL | pysqa-1.0.0-py3-none-any.whl |
|---|---|
| Size | 38.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e3cc95c53ed184eb89347f2e1af411121b6f950e4651fd42478b01ff274e1c98
|
|
BLAKE2b-256 checksum How to use checksums |
f068a431a0a11b31def93abfdf1dbc5d8228b02f573428ae33b3fd1a5ab47fab
|
| 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 31, 2026.
Transparency log
