django-celery python

Old Celery integration project for Django

3 years after

=============================================== django-celery - Celery Integration for Django

.. image::

:Version: 3.1.16 :Web: :Download: :Source: :Keywords: celery, task queue, job queue, asynchronous, rabbitmq, amqp, redis, python, django, webhooks, queue, distributed


.. warning::


Please follow the new tutorial at:

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

import djcelery

Everything works the same as described in the Celery User Manual_, except you need to invoke the programs through

===================================== ===================================== Program Replace with ===================================== ===================================== celery python celery celery worker python celery worker celery beat python celery beat celery ... python celery ... ===================================== =====================================

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

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.

.. django-celery documentation: .. Celery User Manual: .. _Getting started with django-celery:


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 migrate djcelery

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

$ python syncdb

.. _south:

Downloading and installing from source

Download the latest version of django-celery from

You can install it by doing the following,::

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

Using the development version

You can clone the git repository by doing the following::

$ git clone git://

Getting Help

Mailing list

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

.. _celery-users:


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

.. _Freenode:

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to our issue tracker at



Development of django-celery happens at Github:

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.

.. # vim: syntax=rst expandtab tabstop=4 shiftwidth=4 shiftround

Related Repositories



Django, celery and more, all dockerized ...



Django Celery DB Backend that keeps enough info to retry a task. ...



Django Celery DB Backend that keeps enough info to retry a task. ...



1⃣ :snake: :three: Example of using the django-celery module. ...



Django, celery and more, all dockerized ...

Top Contributors

ask ionelmc davidfischer-ch diegueus9 jezdez jasonbaker iamjstates piotrbulinski zpencerq nuklea nvie dlamotte AlvaroVega public zhiwehu jonashaag justquick kipanshi kmike PiotrSikora imankulov Apreche weipin enagorny realitycheck dongweiming rockallite belegnar yourcelf EnTeQuAk


-   v3.1.10 zip tar
-   v3.1.9 zip tar
-   v3.1.1 zip tar
-   v3.1.0 zip tar
-   v3.0.23 zip tar
-   v3.0.21 zip tar
-   v3.0.17 zip tar
-   v3.0.11 zip tar
-   v3.0.10 zip tar
-   v3.0.9 zip tar
-   v3.0.6 zip tar
-   v3.0.4 zip tar
-   v3.0.1 zip tar
-   v3.0.0 zip tar
-   v2.5.5 zip tar
-   v2.5.5-fixsouth3 zip tar
-   v2.5.5-fixsouth2 zip tar
-   v2.5.4 zip tar
-   v2.5.3 zip tar
-   v2.5.2 zip tar
-   v2.5.1 zip tar
-   v2.4.2 zip tar
-   v2.4.1 zip tar
-   v2.4.0 zip tar
-   v2.3.3 zip tar
-   v2.3.2 zip tar
-   v2.3.1 zip tar
-   v2.3.0 zip tar
-   v2.2.7 zip tar
-   v2.2.4 zip tar