Django Tasks RQ
A Django Tasks backend which uses RQ as its underlying queue.
Installation
python -m pip install django-tasks
First, add django_tasks_rq to your INSTALLED_APPS:
INSTALLED_APPS = [
# ...
"django_tasks_rq",
]
Finally, add it to your TASKS configuration:
TASKS = {
"default": {
"BACKEND": "django_tasks_rq.RQBackend",
"QUEUES": ["default"]
}
}
Usage
The RQ-based backend acts as an interface between Django's tasks interface and RQ, allowing tasks to be defined and enqueued using django.tasks, but stored in Redis and executed using RQ's workers.
Any queues defined in QUEUES must also be defined in django-rq's RQ_QUEUES setting.
Job class
To use rq with django-tasks-rq, a custom Job class must be used. This can be passed to the worker using --job-class:
./manage.py rqworker --job-class django_tasks_rq.Job
Priorities
rq has no native concept of priorities - instead relying on workers to define which queues they should pop tasks from in order. Therefore, task.priority has little effect on execution priority.
If a task has a priority of 100, it is enqueued at the top of the queue, and will be the next task executed by a worker. All other priorities will enqueue the task to the back of the queue. The queue value is not stored, and will always be 0.
Contributing
See CONTRIBUTING.md for information on how to contribute.
Note: Prior to 0.12.0, this backend was included in django-tasks. Whilst the commit history was cleaned up, it's still quite messy. Don't look too closely.
Metadata
Release files for django-tasks-rq 0.12.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 | |
|---|---|---|---|
| django_tasks_rq-0.12.0.tar.gz | 10.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| django_tasks_rq-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.9 kB
Release files / django_tasks_rq-0.12.0.tar.gz
| Download URL | django_tasks_rq-0.12.0.tar.gz |
|---|---|
| Size | 10.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
84020a65d7b92d867f28d3002b4a6b07514eeda99b880ad91bb041d63e2191e0
|
|
BLAKE2b-256 checksum How to use checksums |
30d3c964bd32d2fc5df173c49eaab418784034baaf66cfa84ce9be44e7073e2b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 6, 2026.
Transparency logRelease files / django_tasks_rq-0.12.0-py3-none-any.whl
| Download URL | django_tasks_rq-0.12.0-py3-none-any.whl |
|---|---|
| Size | 7.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ece4131fb31bd0410a958504c4491e81a4987eddd654b9b26311af96a743ba0d
|
|
BLAKE2b-256 checksum How to use checksums |
33dd7cdc12b0ce24be13ecd6088c8baa2da4fa7e5b70c6f763570f0b0b750cbe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 6, 2026.
Transparency log