Pre-release

This release is a pre-release and may not be stable for production use.

remoulade

A fast and reliable distributed task processing library for Python 3. Fork of dramatiq.io

Changelog: https://remoulade.readthedocs.io/en/latest/changelog.html
Documentation: https://remoulade.readthedocs.io

Installation

If you want to use it with RabbitMQ

    uv pip install 'remoulade[rabbitmq]'

If you want to use it with PostgreSQL and PGMQ

    uv pip install 'remoulade[postgres]'

If you want Redis-backed extras like results or cancellation, add Redis to the broker extra you use:

   uv pip install 'remoulade[rabbitmq, redis]'
   uv pip install 'remoulade[postgres, redis]'

Quickstart

Make sure you've got RabbitMQ running, then create a new file called example.py:

from remoulade.brokers.rabbitmq import RabbitmqBroker
import remoulade
import requests
import sys

broker = RabbitmqBroker()
remoulade.set_broker(broker)


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


broker.declare_actor(count_words)

if __name__ == "__main__":
    count_words.send(sys.argv[1])

In one terminal, run your workers:

   remoulade example

In another, start enqueueing messages:

   python3 example.py http://example.com
   python3 example.py https://github.com
   python3 example.py https://news.ycombinator.com

Visit the user guide to see more features!.

Releasing

If you want to contribute to the project. First make a Pull request and get approval from a Maintainer and then:

Merge your pull request
Push a tag (must start with a v) from the commit you want (usually, the master branch) a. You can create a new release on Github (recommended). This will create and push the tag for you. b. Update your local clone, checkout master, git tag and then git push --tags

This will trigger a CI/CD pipeline that publish the package

Kubernetes

Remoulade is tailored to run transparently in containers on Kubernetes and to make the most of their features. This does not mean it cannot run outside of Kubernetes ;)

Monitoring/Prometheus

Remoulade provides a Prometheus Middleware that exposes various metrics (processed messages, retries, fails etc.), Check it out.

Tracing/OpenTelemtry

Take a look at opentelemetry-instrumentation-remoulade if you want to enable tracing for Remoulade operations (enqueue, message processing, retries etc.). See here for an example. The library follows OpenTelemetry standards.

License

remoulade is licensed under the LGPL. Please see COPYING and COPYING.LESSER for licensing details.

Release files for remoulade 7.1.0rc1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for remoulade 7.1.0rc1
File	Size	Uploaded
remoulade-7.1.0rc1.tar.gz	115.2 kB	Aug 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for remoulade 7.1.0rc1
File	Interpreter	ABI	Platform	Reset
remoulade-7.1.0rc1-py3-none-any.whl 168.5 kB Aug 20, 2026	Python 3	none	any	Details

Total release size: 283.7 kB

Release files / remoulade-7.1.0rc1.tar.gz

Download URL	remoulade-7.1.0rc1.tar.gz
Size	115.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`6c183fe46fdfb85de77b0799cf29698631eb2eca84b6fe1ea7e4d56175a15699`
BLAKE2b-256 checksum How to use checksums	`0459f6c99e8ee9fd9e3702bbd9e7fdf847f7c8a85fdef122bccb664f82fb26d5`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wiremind/remoulade
Publishing commit: github.com/wiremind/remoulade/tree/6396c1f15d3e5798e3a71274becd12d87fca4993

Workflow

Publishing configuration: github.com/wiremind/remoulade/blob/6396c1f15d3e5798e3a71274becd12d87fca4993/.github/workflows/pythonpublish.yml
Publishing logs: github.com/wiremind/remoulade/actions/runs/32382560746/attempts/1

Artifact

Subject: remoulade-7.1.0rc1.tar.gz
SHA-256 checksum: 6c183fe46fdfb85de77b0799cf29698631eb2eca84b6fe1ea7e4d56175a15699 Verifying attestations

Release files / remoulade-7.1.0rc1-py3-none-any.whl

Download URL	remoulade-7.1.0rc1-py3-none-any.whl
Size	168.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9ed2f9dc0591f2c55f9f0b8ece99ce78e51a9a31694767f37cc408f59a570359`
BLAKE2b-256 checksum How to use checksums	`4d288c1cdc3ea70f88f34c8d2d992e9e4c2bc087779a54bce7b4cb4a9afce664`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wiremind/remoulade
Publishing commit: github.com/wiremind/remoulade/tree/6396c1f15d3e5798e3a71274becd12d87fca4993

Workflow

Publishing configuration: github.com/wiremind/remoulade/blob/6396c1f15d3e5798e3a71274becd12d87fca4993/.github/workflows/pythonpublish.yml
Publishing logs: github.com/wiremind/remoulade/actions/runs/32382560746/attempts/1

Artifact

Subject: remoulade-7.1.0rc1-py3-none-any.whl
SHA-256 checksum: 9ed2f9dc0591f2c55f9f0b8ece99ce78e51a9a31694767f37cc408f59a570359 Verifying attestations