Warning: This document is for the development version of Dramatiq. The latest version is v1.3.0.

Dramatiq: simple task processing

Release v1.3.0. (Installation, Changelog, Discuss, Source Code)

https://img.shields.io/badge/license-LGPL-blue.svg https://travis-ci.org/Bogdanp/dramatiq.svg?branch=master https://badge.fury.io/py/dramatiq.svg

Dramatiq is a distributed task processing library for Python with a focus on simplicity, reliability and performance.

Here’s what it looks like:

import dramatiq
import requests

@dramatiq.actor
def count_words(url):
   response = requests.get(url)
   count = len(response.text.split(" "))
   print(f"There are {count} words at {url!r}.")

# Synchronously count the words on example.com in the current process
count_words("http://example.com")

# or send the actor a message so that it may perform the count
# later, in a separate process.
count_words.send("http://example.com")

Dramatiq is licensed under the LGPL and it officially supports Python 3.5 and later.

Get It Now

If you want to use it with RabbitMQ:

$ pip install -U 'dramatiq[rabbitmq, watch]'

Or if you want to use it with Redis:

$ pip install -U 'dramatiq[redis, watch]'

Read the Motivation behind it or the User Guide if you’re ready to get started.

API Reference

This part of the documentation is focused on detailing the various bits and pieces of the Dramatiq developer interface.

Newsletter

Subscribe to our occasional newsletter to receive up-to-date info on Dramatiq features and changes.