Installation

• Install the latest version with pip:

  $ pip install django-q
  

• Add django_q to INSTALLED_APPS in your projects settings.py:

  INSTALLED_APPS = (
      # other apps
      'django_q',
  )
  

• Run Django migrations to create the database tables:

  $ python manage.py migrate
  

• Make sure you have a Redis server running somewhere and know how to connect to it.

Requirements

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.

Optional

• 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