---
id: dramatiq
version: "2.2.0"
license: unclear
license_treatment: copyleft
maintenance: active
---

# dramatiq — Background Processing for Python 3.

License: copyleft · Maintenance: active · Downloads: 1.6M/mo

## What it is and what it does

Dramatiq is a distributed task processing library for Python that decouples work from the main application by sending tasks to a message broker for background execution. You define tasks as Python functions decorated with @dramatiq.actor, then call .send() to queue them asynchronously. Workers consume messages from the broker and execute the tasks in parallel, enabling you to handle long-running or resource-intensive operations without blocking your main application.

The library supports RabbitMQ and Redis as message brokers and requires Python 3.10 or later. It has no runtime dependencies beyond the broker itself, making installation straightforward. The project is actively maintained with recent releases and a stable API, suitable for production use in applications that need reliable background job processing.

Use it for:

- Queue long-running HTTP requests or API calls to execute in the background without blocking the main application
- Distribute CPU-intensive computations across multiple worker processes or machines
- Send transactional emails, notifications, or batch reports asynchronously after user actions
- Process uploaded files, generate reports, or perform data transformations on a schedule or on-demand
- Implement retry logic and error handling for operations that may fail intermittently

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Dramatiq is a distributed task processing library that lets you define Python functions as background workers and queue them for asynchronous execution via message brokers like RabbitMQ or Redis.

Yes. Dramatiq is a mature, actively maintained library with no known vulnerabilities and low install friction. It's well-suited for any Python application that needs reliable background task processing. The copyleft license is a consideration only if you plan to modify and redistribute the library itself. Choose it if you need a straightforward, production-ready task queue backed by RabbitMQ or Redis.

## Install

pip install dramatiq
uv add dramatiq
poetry add dramatiq

## Installing dramatiq

Before you install: Installation is low-friction; the package itself is a pure Python wheel with no runtime dependencies. Maintenance is active with a recent release and ongoing commits, though you'll need to separately install and run a message broker as a prerequisite.

License in practice: Licensed under LGPLv3+, a copyleft license. You can use it freely in open-source projects, but if you distribute or deploy a modified version, you must make your changes available under the same license terms.

Quickstart:

pip install 'dramatiq[rabbitmq]'

import dramatiq

@dramatiq.actor
def my_task(x):
    return x * 2

my_task.send()

A running RabbitMQ or Redis broker is required; dramatiq itself is only the client and worker library.

Verify before relying:

- Whether the package supports task result persistence or only fire-and-forget semantics
- Retry and error-handling policies available beyond what the quickstart shows
- Performance characteristics and throughput limits under typical workloads

## Package facts

- License: not declared (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

distributed task queue, background job processing, async task worker, message broker task processing, python task scheduling, rabbitmq worker library, redis job queue, task-queue, background-jobs, message-broker

[View on SkillFed](https://skillfed.io/packages/dramatiq) · [View on PyPI](https://pypi.org/project/dramatiq/)