Skip to content

A fast and reliable background task processing library for Python 3.

License

LGPL-3.0, GPL-3.0 licenses found

Licenses found

LGPL-3.0
COPYING.LESSER
GPL-3.0
COPYING
Notifications You must be signed in to change notification settings

Bogdanp/dramatiq

Folders and files

NameName
Last commit message
Last commit date
Apr 16, 2025
Nov 15, 2017
Sep 29, 2018
Nov 24, 2018
Mar 11, 2025
Apr 18, 2025
Apr 2, 2023
Apr 16, 2025
Oct 26, 2024
Nov 25, 2018
Oct 18, 2020
Apr 16, 2025
Mar 31, 2018
Mar 31, 2018
Feb 25, 2023
Nov 28, 2024
Mar 18, 2022
Sep 19, 2021
Jan 25, 2024
Nov 5, 2024
Nov 5, 2024

Repository files navigation

dramatiq

Build Status PyPI version Documentation Discuss

A fast and reliable distributed task processing library for Python 3.


Changelog: https://dramatiq.io/changelog.html
Community: https://groups.io/g/dramatiq-users
Documentation: https://dramatiq.io


Sponsors

Installation

If you want to use it with RabbitMQ

pip install 'dramatiq[rabbitmq, watch]'

or if you want to use it with Redis

pip install 'dramatiq[redis, watch]'

Quickstart

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

import dramatiq
import requests
import sys


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


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

In one terminal, run your workers:

dramatiq example

In another, start enqueueing messages:

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

Check out the user guide to learn more!

License

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