• Install the latest version with pip:

    $ pip install django-q
  • Add django_q to INSTALLED_APPS in your projects

        # other apps
  • Run Django migrations to create the database tables:

    $ python migrate
  • Choose a message broker , configure it and install the appropriate client library.


Django Q is tested for Python 2.7 and 3.4

  • Django

    Django Q aims to use as much of Django’s standard offerings as possible The code is tested against Django version 1.7.10 and 1.8.4.

  • Django-picklefield

    Used to store args, kwargs and result objects in the database.

  • Arrow

    The scheduler uses Chris Smith’s wonderful project to determine correct dates in the future.

  • Blessed

    This feature-filled fork of Erik Rose’s blessings project provides the terminal layout of the monitor.


  • Redis-py client by Andy McCurdy is used to interface with both the Redis and Disque brokers:

    $ pip install redis
  • Psutil python system and process utilities module by Giampaolo Rodola’, is an optional requirement and adds cpu affinity settings to the cluster:

    $ pip install psutil
  • Hiredis parser. This C library maintained by the core Redis team is faster than the standard PythonParser during high loads:

    $ pip install hiredis
  • Boto3 is used for the Amazon SQS broker in favor of the now deprecating boto library:

    $ pip install boto3
  • Iron-mq is the official python binding for the IronMQ broker:

    $ pip install iron-mq
  • Redis server is the default broker for Django Q. It provides the best performance and does not require Django’s cache framework for monitoring.

  • Disque server is based on Redis by the same author, but focuses on reliable queues. Currently in Alpha, but highly recommended. You can either build it from source or use it on Heroku through the Tynd beta.