• 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
  • Make sure you have a Redis server running somewhere and know how to connect to it.


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.

  • Redis-py

    Andy McCurdy’s excellent Redis python client.

  • 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 server

    Django Q uses Redis as a centralized hub between your Django instances and your Q clusters.


  • 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