Example Django project using Celery

Contents

proj/

This is the project iself, created using django-admin.py startproject proj, and then the settings module (proj/settings.py) was modified to add demoapp to INSTALLED_APPS

proj/celery.py

This module contains the Celery application instance for this project, we take configuration from Django settings and use autodiscover_tasks to find task modules inside all packages listed in INSTALLED_APPS.

demoapp/

Example generic app. This is decoupled from the rest of the project by using the @shared_task decorator. This decorator returns a proxy that always points to the currently active Celery instance.

Starting the worker

The DJANGO_SETTINGS_MODULE environment must be set when starting the worker:

$ DJANGO_SETTINGS_MODULE='proj.settings' celery -A proj worker -l info