{"id":21139,"library":"django-celery","title":"Django Celery","description":"Legacy integration package for using Celery with Django. Current version 3.3.1 is deprecated; the project is in maintenance mode and no longer actively developed. Users should migrate to the built-in Celery integration available in Celery 3.1+. Release cadence: sporadic, last release in 2016.","status":"deprecated","version":"3.3.1","language":"python","source_language":"en","source_url":"https://github.com/celery/django-celery","tags":["django","celery","task-queue","deprecated"],"install":[{"cmd":"pip install django-celery==3.3.1","lang":"bash","label":"Install legacy version"}],"dependencies":[],"imports":[{"note":"django-celery provides 'djcelery' module, not 'celery'. Straight celery import bypasses Django integration.","wrong":"from celery import Celery (then using django-celery)","symbol":"djcelery","correct":"from djcelery import celery"}],"quickstart":{"code":"INSTALLED_APPS = ['djcelery']\nimport djcelery\ndjcelery.setup_loader()\nfrom djcelery.models import PeriodicTask","lang":"python","description":"Add 'djcelery' to INSTALLED_APPS, call setup_loader(), and use djcelery models. This is deprecated; use celery.app directly."},"warnings":[{"fix":"Remove django-celery and use Celery directly: pip install celery[redis]; configure CELERY_BROKER_URL in settings; use from celery import Celery","message":"django-celery is deprecated. Use Celery's built-in Django support (installed_apps=['celery']) and Django 1.8+.","severity":"deprecated","affected_versions":">=3.0"},{"fix":"Call setup_loader() in the manage.py or wsgi.py before django.setup(), or use the modern patten: from celery import Celery; app = Celery('proj'); app.config_from_object('django.conf:settings')","message":"djcelery.setup_loader() cannot be called after Django apps are loaded (e.g., in settings). Placing it in settings.py can cause AppRegistryNotReady errors.","severity":"breaking","affected_versions":"all"},{"fix":"Use Celery >=4.0 with its native Django integration; remove django-celery from requirements.","message":"django-celery is incompatible with Celery 4.x. Attempting to install both will cause ImportError on 'fixups' or missing 'celery.current_app'.","severity":"gotcha","affected_versions":"django-celery < 4"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"pip install django-celery and add 'djcelery' to INSTALLED_APPS","cause":"django-celery not installed or not added to INSTALLED_APPS","error":"ImportError: No module named djcelery"},{"fix":"Move setup_loader() call to manage.py before execute_from_command_line() or upgrade to Celery native integration (no setup_loader needed).","cause":"Calling djcelery.setup_loader() after Django apps have been populated, often in settings.py","error":"RuntimeError: populate() isn't reentrant"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}