Repo brief: Bogdanp/dramatiq

Generated by RepoPilot · document generated 2026-09-17 · concise human review Evidence snapshot · analyzed 2026-09-17T04:07:45.635Z · commit 848b35f2f960

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit 2w ago
• 11 active contributors
• LGPL-3.0 licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against OpenSSF Scorecard

What it is

Dramatiq is a fast, reliable distributed task queue library for Python 3 that enables background job processing with support for multiple brokers (RabbitMQ, Redis). It decouples task producers from workers through message-passing, allowing asynchronous execution of long-running operations while the application remains responsive. Monolithic package structure: dramatiq/ contains the core engine (actor.py, broker.py, message.py, encoder.py), dramatiq/brokers/ provides pluggable broker implementations (rabbitmq.py, redis.py, stub.py), dramatiq/middleware/ contains cross-cutting concerns (retries.py, callbacks.py, pipelines.py, prometheus.py), and dramatiq/rate_limits/ provides…

Start here

Open these first:

• dramatiq/broker.py — Core broker abstraction that all message queue implementations extend; defines the contract for task enqueueing and worker…
• dramatiq/actor.py — Task decorator and actor definition system; every background job is defined through this module's @actor decorator.
• dramatiq/worker.py — Main worker event loop that processes messages from the broker; handles concurrency, retries, and middleware invocation.
• dramatiq/middleware/middleware.py — Middleware base class and orchestration system; enables hooks into message processing pipeline for retries, rate-limiting,…
• dramatiq/brokers/rabbitmq.py — Primary RabbitMQ broker implementation; handles connection pooling, message encoding, and acknowledgment semantics.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/Bogdanp/dramatiq.git
cd dramatiq
pip install -e '.[rabbitmq,watch]'  # or [redis,watch] for Redis broker
dramatiq example  # requires example.py with @dramatiq.actor decorated functions

Note: Requires RabbitMQ or Redis service running separately.

Daily commands:

Start a broker (RabbitMQ or Redis), then run dramatiq example to spawn workers. Send tasks via python example.py <args> or programmatically via actor_name.send(...). No dev server—this is a task processing library…

…shortened for this brief.

Key cautions & unknowns

• Single-maintainer risk — top contributor 80% of recent commits
• LGPL-3.0 is copyleft — check downstream compatibility
• Broker dependency: Must have RabbitMQ or Redis running before starting workers; stub broker is for testing only. Middleware ordering: Middleware chain order matters (e.g., retries must wrap time_limit);…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.