Bogdanp

dramatiq: Run Background Tasks in Python

Dramatiq is a Python library for distributing background jobs through RabbitMQ or Redis. It suits Python services that need workers to process tasks outside the request path, with an active project and an LGPL license to review.

View on GitHub Compare
Stars
5.3k
Forks
385
Stars, last 30 days
+11
Last commit
today
Contributors
100+

Our take

Activeregular commits and releases

Health score

52/100

How it is scored
Activity
55
Community
72
Issues
33
Pull requests
47

+11 stars in the last 30 days

  • More contributors than 78% of the projects we track
  • Slower to close issues than 96% of the projects we track

Dramatiq is an actively maintained Python task queue with two broker options, and its LGPL license and broker dependency are important adoption considerations.

Good fit if

  • Your application is written in Python and needs separate workers to handle queued tasks.
  • You already use, or are willing to operate, RabbitMQ or Redis.
  • You want a project with recent commits and releases, and a contributor base that is not concentrated in one person.

Look elsewhere if

  • You need a task system that does not rely on RabbitMQ or Redis.
  • Your licensing requirements are incompatible with LGPL-3.0.
  • You need issues to be resolved quickly as a key adoption requirement, since reported issue closure times are long.
All health signals
Last commit2026-10-13 (today)
Commits, last 90 days23
Releases, last 12 months5 (latest v2.2.1, 2026-09-02)
Contributors100+ (top contributor: 66% of commits)
Issues closed, last 90 days4 (typically closed in 490 days)
Pull requests merged, last 90 days13 (typically merged in 1 day)
Project age9 years

Checked on 2026-10-14 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

5,340

Forks

389

Change since Nov 16, 2026: 0 stars·0 forks

Overview

Dramatiq is a distributed task-processing library for Python 3. It lets an application enqueue work for separate worker processes, so tasks such as fetching a page or processing data can run outside the process that requested them.

It uses RabbitMQ or Redis as a message broker. The repository describes the project as fast and reliable, but does not provide comparative benchmarks in the supplied material.

Key Features

  • Define background jobs as Python functions decorated with @dramatiq.actor.
  • Enqueue actor calls as messages for workers to process.
  • Run workers from the command line against a Python module.
  • Use RabbitMQ or Redis as the broker.
  • Install optional broker and file-watching dependencies through package extras.
  • Use the published documentation and user guide for setup and operation.

Use Cases

  • Python web services can hand off slow work, such as fetching remote pages, to worker processes.
  • Applications with multiple workers can distribute queued tasks through RabbitMQ or Redis.
  • Teams building Python task pipelines can keep task definitions in ordinary Python functions and enqueue calls from application code.
  • Developers who want to try a broker-backed worker locally can start with the documented single-actor example.

What you need

Detected in the repository

  • Python (from pyproject.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

LGPL-3.0weak copyleft

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license notice
  • Share your changes: yes, changes to the library itself, when you distribute it; linking from closed code is allowed
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install Dramatiq with the broker extra you plan to use:

pip install 'dramatiq[rabbitmq, watch]'

Or install the Redis extra with pip install 'dramatiq[redis, watch]'. See the README and user guide for worker setup and usage.

Alternatives

  • sidequest: Sidequest is a Node.js job processor backed by SQL or MongoDB, while Dramatiq is a Python library built around RabbitMQ or Redis.
  • mrq: MRQ is a Python task queue using Redis or MongoDB and gevent, while Dramatiq uses RabbitMQ or Redis.
ProjectLanguageLicenseStarsStatus
dramatiqPythonLGPL-3.05.3kActive
sidequestTypeScriptLGPL-3.01kActive
mrqPythonMIT892Inactive

Considerations

  • A broker is required: choose RabbitMQ or Redis and make it available to the workers and application.
  • The project is active, with regular commits and releases, and has at least 100 contributors. Contribution is not concentrated in one person. However, the measured median time to close issues is lengthy, while merged pull requests have a much shorter median turnaround.
  • Dramatiq is licensed under LGPL-3.0. Review the license terms for your distribution and integration model before adopting it.

Found this useful?

Share it with someone who would like dramatiq.

Comparisons