Skip to main content

Frontend for SLURM/LSF/PBS

Project description Documentation Status


MyQueue is a tool for submitting and keeping track of tasks running on a cluster of computers. It uses SLURM, PBS or LSF as a backend and makes handling of tasks easy. It has a command-line interface called mq with a number of sub-commands and a Python interface for managing workflows. Simple to set up: no system administrator or database required.

Quick links:


Submit Python script to 32 cores for 2 hours:

$ mq submit -R 32:2h

Submit Python module in two folders:

$ mq submit F1/ F2/ -R 16:30m

Check results of tasks in current folder and its sub-folders:

$ mq list  # or mq ls
id  folder name      res.   age     state   time    error
--- ------ --------- ------ ------- ------- ------- ------
117 ./ 32:2h  5:28:43 TIMEOUT 2:00:03
118 ./F1/   16:30m 5:22:16 done      12:12
119 ./F2/   16:30m 5:22:16 done      17:50
--- ------ --------- ------ ------- ------- ------- ------
done: 2, TIMEOUT: 1, total: 3

Resubmit with more resources (1 day):

$ mq resubmit -i 117 -R 32:1d

See more examples of use here:


MyQueue needs Python version 3.8 or later.

Install MyQueue from PyPI with pip:

$ python3 -m pip install myqueue

This will also install the rich and networkx packages that MyQueue depends on.

Enable bash tab-completion for future terminal sessions like this:

$ mq completion >> ~/.profile

Now, configure your system as described here.

Release notes

See the release notes for a history of notable changes to MyQueue.

Help, support and feedback

If you need help, want to report a bug or suggest a new feature then you are welcome to get in touch via MyQueue’s issue tracker or the #myqueue room on Matrix.


We welcome contributions to the code and documentation, preferably as merge-requests. More information here.

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

myqueue-24.1.0.tar.gz (131.9 kB view hashes)

Uploaded Source

Built Distribution

myqueue-24.1.0-py3-none-any.whl (106.6 kB view hashes)

Uploaded Python 3

Supported by

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