Celery integration for Django (MOVED TO: celery/django-celery)
Python Shell
Pull request Compare This branch is 3 commits ahead, 360 commits behind celery:master.
Latest commit c565202 Jun 6, 2012 @ask Docs have moved to Celery main
Failed to load latest commit information.
bin Forgot to add bin/djcelerymon. Closes #17. Thanks to kmmbvnr Oct 5, 2010
contrib Tests passing Feb 24, 2012
djcelery Fixes typo May 30, 2012
docs Docs have moved to Celery main Jun 6, 2012
examples/demoproject Upgrade demoproject to use Django 1.4 template Apr 12, 2012
locale generated mo file for spanish translation May 12, 2012
requirements No longer depends on django-picklefield and does not deepcopy results Apr 23, 2012
.gitignore Fixed timezone support in Django 1.4 by conditionally converting time… Jan 11, 2012
AUTHORS Adds Roman Imankulov to AUTHORS May 16, 2012
Changelog Bumps verison to 2.5.5 and updates Changelog Apr 19, 2012
FAQ Fix #76: Made the test runner compatible with Django 1.4 Sep 25, 2011
LICENSE Update year in LICENSE Jul 14, 2011
MANIFEST.in Moves contrib/requirements to top directory Apr 4, 2011
README Added standard distribution files and a first draft for a README May 20, 2010
THANKS Added standard distribution files and a first draft for a README May 20, 2010
TODO Added standard distribution files and a first draft for a README May 20, 2010
pavement.py Upgrade distribution tools Oct 28, 2011
setup.cfg Now depends on Celery 2.5.2 Apr 12, 2012
tox.ini Tests passing on 2.4/2.5 Jan 12, 2012


django-celery - Celery Integration for Django


Keywords:celery, task queue, job queue, asynchronous, rabbitmq, amqp, redis, python, django, webhooks, queue, distributed


django-celery provides Celery integration for Django; Using the Django ORM and cache backend for storing results, autodiscovery of task modules for applications listed in INSTALLED_APPS, and more.

Using django-celery

To enable django-celery for your project you need to add djcelery to INSTALLED_APPS:

INSTALLED_APPS += ("djcelery", )

then add the following lines to your settings.py:

import djcelery

Everything works the same as described in the Celery User Manual, except you need to invoke the programs through manage.py:

Program Replace with
celeryd python manage.py celeryd
celeryctl python manage.py celeryctl
celerybeat python manage.py celerybeat
camqadm python manage.py camqadm
celeryev python manage.py celeryev
celeryd-multi python manage.py celeryd_multi

The other main difference is that configuration values are stored in your Django projects' settings.py module rather than in celeryconfig.py.

If you're trying celery for the first time you should start by reading Getting started with django-celery

Special note for mod_wsgi users

If you're using mod_wsgi to deploy your Django application you need to include the following in your .wsgi module:

import djcelery


The Celery User Manual contains user guides, tutorials and an API reference. Also the django-celery documentation, contains information about the Django integration.


You can install django-celery either via the Python Package Index (PyPI) or from source.

To install using pip,:

$ pip install django-celery

To install using easy_install,:

$ easy_install django-celery

You will then want to create the necessary tables. If you are using south for schema migrations, you'll want to:

$ python manage.py migrate djcelery

For those who are not using south, a normal syncdb will work:

$ python manage.py syncdb

Downloading and installing from source

Download the latest version of django-celery from http://pypi.python.org/pypi/django-celery/

You can install it by doing the following,:

$ tar xvfz django-celery-0.0.0.tar.gz
$ cd django-celery-0.0.0
# python setup.py install # as root

Using the development version

You can clone the git repository by doing the following:

$ git clone git://github.com/ask/django-celery.git

Getting Help

Mailing list

For discussions about the usage, development, and future of celery, please join the celery-users mailing list.


Come chat with us on IRC. The #celery channel is located at the Freenode network.

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to our issue tracker at http://github.com/ask/django-celery/issues/




Development of django-celery happens at Github: http://github.com/ask/django-celery

You are highly encouraged to participate in the development. If you don't like Github (for some reason) you're welcome to send regular patches.


This software is licensed under the New BSD License. See the LICENSE file in the top distribution directory for the full license text.