Awesome Open Source
Awesome Open Source

.. image:: :target:

.. image:: :target:

.. image:: :target:

.. image:: :target:

.. image:: :target:

.. image:: :target:

.. image:: /docs/source/images/carrot-logo-big.png :align: center

django-carrot is a lightweight task queue backend for Django projects that uses the RabbitMQ message broker, with an emphasis on quick and easy configuration and task tracking


Install django-carrot:

.. code-block:: bash

pip install django-carrot

Install and run RabbitMQ

.. code-block:: bash

brew install rabbitmq
brew services start rabbitmq


  1. Add carrot to your Django project's settings module:

.. code-block:: python

  1. Apply the carrot migrations to your project's database:

.. code-block:: python

python migrate carrot


To start the service:

.. code-block:: bash

python carrot_daemon start

To run tasks asynchronously:

.. code-block:: python

from carrot.utilities import publish_message

def my_task(**kwargs):
    return 'hello world'

publish_message(my_task, hello=True)

To schedule tasks to run at a given interval

.. code-block:: python

from carrot.utilities import create_scheduled_task

create_scheduled_task(my_task, {'seconds': 5}, hello=True)

.. note:: The above commands must be made from within the Django environment


A sample docker config is available here <>_

Full documentation

The full documentation is available here <>_


If you are having any issues, please log an issue <>_


Django-carrot uses Packagr <>_ to share development builds. If you'd like access to it, please send me your email address at [email protected] so I can give you access


The project is licensed under the Apache license.

Icons made by Trinh Ho from <>_ is licensed by CC 3.0 BY

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (54,333
python3 (1,640
django (1,030
rabbitmq (257
task-queue (19