django-tasks-db

What it is and what it does

django-tasks-db is a backend for Django's built-in task system that stores task definitions and results directly in your application database instead of requiring a separate message broker or task queue service. It integrates with Django's ORM and provides a management command to run a worker process that executes queued tasks. This approach eliminates the operational complexity of running Redis, RabbitMQ, or Celery, making it suitable for smaller deployments or applications where database-backed task storage is acceptable.

The package supports customizable task ID generation, automatic task result pruning via management command, and development-mode auto-reload. It's actively maintained and supports Django 4.2 through 6.0 on Python 3.10+. Since tasks live in your database, you get built-in persistence and can query task status directly through Django's ORM, but you trade off the scalability and decoupling that external task queues provide.

Use it for:

• Run background jobs in Django without deploying Redis or RabbitMQ.
• Store and audit all task executions in your application database for compliance or debugging.
• Prototype or develop task-based features before committing to a separate queue infrastructure.
• Execute periodic or triggered work within a single-server or small-scale deployment.
• Query task history and status directly via Django ORM without a separate monitoring tool.

Worth the install?

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

A Django Tasks backend that stores and executes asynchronous tasks in your database using Django's ORM, with a management command to run a worker process.

Yes, if you want a lightweight, database-backed task queue for Django without external infrastructure. The active maintenance, low install friction, and permissive license make it a solid choice for small to medium projects. Not recommended if you need high-throughput task processing, distributed workers across multiple machines, or the decoupling that external queues provide.

Install

django-tasks-db on PyPI

pip install django-tasks-db

uv add django-tasks-db

poetry add django-tasks-db

Installing django-tasks-db

Before you install

Low install friction with a pure-Python wheel. Actively maintained with recent commits and a stable release. Requires Django, typing_extensions, django-stubs-ext, and django-tasks as runtime dependencies.

License in practice

BSD-3-Clause is a permissive license that allows commercial use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart

pip install django-tasks-db

# In settings.py
INSTALLED_APPS = ["django_tasks_db"]
TASKS = {"default": {"BACKEND": "django_tasks_db.DatabaseBackend", "QUEUES": ["default"]}}

# Run worker
./manage.py db_worker

Requires Python 3.10 or later and Django 4.2+; tasks are stored in the database so schema migrations are needed after installation.

Verify before relying

• Whether the database backend scales adequately for high-volume task workloads compared to external task queues.
• Performance characteristics when pruning large accumulated task result sets.
• Support for distributed workers across multiple processes or machines.

Package facts

Evidence: django_tasks_db-0.12.0-py3-none-any.whl

Tags

More WWW/HTTP packages