Skip to main content

remoulade

CircleCI PyPI version Documentation

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

  1. 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])
  1. In one terminal, run your workers:
   remoulade example
  1. 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:

  1. Merge your pull request
  2. 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.

Metadata

Release files for remoulade 8.1.1

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 8.1.1
File Size Uploaded Provenance Actions
remoulade-8.1.1.tar.gz 120.6 kB With provenance Details for remoulade-8.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for remoulade 8.1.1
File Interpreter ABI Platform Actions
remoulade-8.1.1-py3-none-any.whl Python 3 none any Details for remoulade-8.1.1-py3-none-any.whl

Total release size: 293.6 kB

Release files / remoulade-8.1.1.tar.gz

Download URL remoulade-8.1.1.tar.gz
Size 120.6 kB
Tags Source
SHA-256 checksum
How to use checksums
1b632cf1e240bc7abea62a60aa723edc5a3df3592c4d4efa4767e5676737b63b
BLAKE2b-256 checksum
How to use checksums
b522e60775031aaab9ccf1a98ed736b55af4bc5f76c6399dd33e704ce79ea2d4
Upload date
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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / remoulade-8.1.1-py3-none-any.whl

Download URL remoulade-8.1.1-py3-none-any.whl
Size 172.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
76326fdaebde4966729246bfca3ecf177e218843ccad2f5eae91565f58db29b8
BLAKE2b-256 checksum
How to use checksums
84477c2964773f201cc718c74dd3247e0bbf45613d1d8494de563d04930dd431
Upload date
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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for remoulade 8.1.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for remoulade-8.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

8.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page