Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
August 4, 2016 20:17
August 23, 2016 19:08
March 13, 2023 17:19
November 22, 2021 21:52
October 28, 2021 16:07
July 29, 2021 22:15

Celery Result Backends using the Django ORM/Cache framework.

Build status coverage BSD License django-celery-results can be installed via wheel Supported Python versions. Support Python implementations.

Keywords:django, celery, database, results


This extension enables you to store Celery task results using the Django ORM.

It defines a single model (django_celery_results.models.TaskResult) used to store task results, and you can query this database table like any other Django model.


The installation instructions for this extension is available from the Celery documentation


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

To install using pip,:

$ pip install -U django-celery-results

Downloading and installing from source

Download the latest version of django-celery-results from

You can install it by doing the following,:

$ tar xvfz django-celery-results-0.0.0.tar.gz
$ cd django-celery-results-0.0.0
$ python build
# python install

The last command must be executed as a privileged user if you are not currently using a virtualenv.

Using the development version

With pip

You can install the latest snapshot of django-celery-results using the following pip command:

$ pip install

Issues with mysql

If you want to run django-celery-results with MySQL, you might run into some issues.

One such issue is when you try to run python migrate django_celery_results, you might get the following error:

django.db.utils.OperationalError: (1071, 'Specified key was too long; max key length is 767 bytes')

To get around this issue, you can set:


(or any other value if any other db other than MySQL is causing similar issues.)

max_length of 191 seems to work for MySQL.

django-celery-results for enterprise

Available as part of the Tidelift Subscription.

The maintainer of django-celery-results and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainer of the exact packages you use. Learn more.