Skip to main content

Django Tasks RQ

CI PyPI PyPI - Python Version PyPI - Status PyPI - License

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)

Source distribution for django-tasks-rq 0.12.0
File Size Uploaded
django_tasks_rq-0.12.0.tar.gz 10.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for django-tasks-rq 0.12.0
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.12.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page