django-q2

What it is and what it does

Django Q2 is a task queue and scheduler built for Django applications that need to run work asynchronously or on a schedule. It uses a multiprocessing worker pool to execute tasks in the background, freeing up your web requests to complete faster. You define tasks as function calls, queue them with async_task(), and the cluster executes them when workers are available. Results are stored in a database or cache, and you can attach hooks to run code when a task finishes.

The package supports multiple message brokers (Redis, IronMQ, SQS, MongoDB, or the Django ORM itself) so you can choose based on your infrastructure. It includes Django Admin integration for monitoring, a command-line monitor tool, and support for scheduled and cron-based recurring tasks. Django Q2 is a maintained fork of the original Django Q, with updated dependencies, support for Django 5.2 through 6.1, and Python 3.10 through 3.14.

Use it for:

• Offload long-running operations (file uploads, image processing, API calls) from web requests to background workers.
• Schedule recurring tasks like daily reports, cache refreshes, or cleanup jobs using cron expressions or simple interval rules.
• Implement task chains and result hooks to coordinate multi-step workflows where one task's output feeds into the next.
• Monitor task execution and worker health through Django Admin or command-line tools without external monitoring services.
• Scale task processing across multiple instances in a PaaS environment using a shared broker like Redis or SQS.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Django Q2 is a multiprocessing distributed task queue for Django that lets you offload work to background workers, schedule recurring tasks, and monitor job execution through Django Admin.

Yes. Django Q2 is actively maintained, has no known vulnerabilities, and offers a lightweight alternative to Celery for Django projects that need task queueing and scheduling. The low install friction, permissive MIT license, and support for modern Django and Python versions make it a solid choice. Install it if you need background task processing and prefer a simpler, Django-native solution over a separate message broker architecture.

Install

django-q2 on PyPI

pip install django-q2

uv add django-q2

poetry add django-q2

Installing django-q2

Before you install

Low install friction with three runtime dependencies. The package is actively maintained with a recent release and no known vulnerabilities. Requires Django 5.2, 6.0, or 6.1 and Python 3.10 or later.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install django-q2

# In settings.py, add to INSTALLED_APPS:
INSTALLED_APPS = (
    'django_q',
)

# Then run migrations:
python manage.py migrate

# In your code:
from django_q.tasks import async_task
async_task('math.copysign', 2, -2)

Requires a message broker (Redis, IronMQ, SQS, MongoDB, or Django ORM) to be configured and running. Management commands require the Blessed library to be installed separately.

Verify before relying

• Whether the package's broker support (Redis, IronMQ, SQS, MongoDB, ORM) is equally mature across all options or if some are better-tested than others.
• Performance characteristics and scalability limits for the multiprocessing worker pool under production load.
• Whether Sentry and Rollbar integrations are actively maintained and fully functional in the current version.

Package facts

Evidence: django_q2-1.11.0-py3-none-any.whl

Keywords: django, distributed, multiprocessing, queue, scheduler

Tags

More Python Modules packages