Installation

Dramatiq supports Python versions 3.6 and up and is installable via pip or from source.

Via pip

To install dramatiq, simply run the following command in a terminal:

$ pip install -U dramatiq[rabbitmq, watch]

RabbitMQ is the recommended message broker, but Dramatiq also supports Redis.

If you would like to use it with Redis then run:

$ pip install -U dramatiq[redis, watch]

If you don’t have pip installed, check out this guide.

Extra Requirements

When installing the package via pip you can specify the following extra requirements:

Name Description
memcached Installs the required dependencies for the Memcached rate limiter backend.
rabbitmq Installs the required dependencies for using Dramatiq with RabbitMQ.
redis Installs the required dependencies for using Dramatiq with Redis.
watch Installs the required dependencies for the --watch flag. Not available under PyPy.

If you want to install Dramatiq with all available features, run:

$ pip install -U dramatiq[memcached, rabbitmq, redis, watch]

Optional Requirements

If you’re using Redis as your broker and aren’t planning on using PyPy then you should additionally install the hiredis package to get an increase in throughput.

From Source

To install the latest development version of dramatiq from source, clone the repo from GitHub

$ git clone https://github.com/Bogdanp/dramatiq

then install it to your local site-packages by running

$ python setup.py install

in the cloned directory.