rq

rq: Queue Python Jobs with Redis or Valkey

RQ is a Python library for queueing jobs and running them in the background with workers, backed by Redis or Valkey. It offers a straightforward way to move blocking work out of an application’s main flow, with scheduling, retries, and worker scaling.

Stars
10.7k
Forks
1.5k
Stars, last 30 days
+11
Last commit
today
Contributors
100+

Our take

Activeregular commits and releases

Health score

66/100

How it is scored
Activity
65
Community
86
Issues
53
Pull requests
59

+11 stars in the last 30 days

  • Merges more pull requests than 83% of the projects we track
  • More contributors than 78% of the projects we track

RQ is an actively maintained, focused choice for Python background jobs when a Redis or Valkey service is already available and its worker model fits the workload.

Good fit if

  • Your application is Python-based and you want a direct function-call queue backed by Redis or Valkey.
  • You need delayed, recurring, prioritized, or retryable jobs without adopting a broader queueing framework.
  • You value a project with regular commits and releases, broad contributor participation, and quick median pull-request merges.

Look elsewhere if

  • You cannot operate Redis or Valkey, or your runtime is below Python 3.10.
  • Your jobs need a different execution model: RQ’s process-based workers provide isolation, while SimpleWorker runs jobs in-process.
  • Your security requirements do not permit the default pickle serializer and you cannot constrain job arguments to a supported alternative such as JSON.
All health signals
Last commit2026-11-06 (today)
Commits, last 90 days82
Releases, last 12 months9 (latest v3.0, 2026-10-28)
Contributors100+ (top contributor: 35% of commits)
Issues closed, last 90 days12+ (typically closed in 13 days)
Pull requests merged, last 90 days74 (typically merged in 1 day)
Project age14 years

Checked on 2026-11-06 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

10,705

Forks

1,526

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

Overview

RQ (Redis Queue) is a Python library built on Redis or Valkey for queueing function calls and processing them in the background with workers. It helps Python applications move lengthy or blocking tasks out of request handling while keeping the queueing model relatively simple.

Applications enqueue jobs through RQ, and worker processes consume them from named queues. Its features include delayed and recurring work, retries, prioritization, and webhooks. See the RQ documentation for configuration and operational details.

Key Features

  • Enqueue Python function calls for background execution.
  • Use multiple queues and worker processes to prioritize and scale job processing.
  • Schedule jobs for a future time or repeat them at intervals.
  • Configure recurring jobs with intervals or cron syntax.
  • Retry failed jobs with configurable retry intervals.
  • Avoid duplicate enqueues with unique jobs and limit concurrent jobs sharing a key.
  • Send HTTP webhooks when jobs finish or fail.
  • Run jobs with worker types that trade process isolation for execution overhead.

Use Cases

  • A web application can queue email delivery or other blocking work so it does not run in the request path.
  • A team can route urgent and routine jobs to separate queues and allocate workers accordingly.
  • An operations team can schedule recurring maintenance or reporting jobs with interval or cron rules.
  • A Python service can retry transiently failing tasks and notify another system through webhooks.

What you need

Detected in the repository

  • Python >=3.10 (from pyproject.toml)
  • A Dockerfile, so it can run in a container
  • A test suite and automated checks on GitHub Actions

Getting Started

Install RQ with pip:

pip install rq

RQ also requires Redis 5 or newer, or Valkey 7.2 or newer. Start a Redis/Valkey server, then follow the README and documentation to enqueue jobs and run workers.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • dramatiq: Dramatiq is a Python task queue using RabbitMQ or Redis, while RQ is centered on Redis or Valkey.
  • huey: Huey is a lightweight Python task queue with multiple storage backends and Django integration; RQ uses Redis or Valkey.
  • mrq: MRQ is a Python task queue built around MongoDB, Redis, and gevent, with a dashboard; RQ uses Redis or Valkey.
ProjectLanguageLicenseStarsStatus
rqPython–10.7kActive
dramatiqPythonLGPL-3.05.3kActive
hueyPythonMIT6kActive
mrqPythonMIT892Inactive

Considerations

  • RQ depends on a reachable Redis or Valkey service, so that service is part of the deployment and operations requirements.
  • The default serializer uses Python pickle, which the project warns can execute code during deserialization. Use it only with trusted Redis data, or configure an alternative serializer such as JSON and account for its more limited argument types.
  • SimpleWorker runs jobs in the worker process rather than isolating each job in a separate process. The README recommends Worker or SpawnWorker for production where crash, memory-leak, or hard-timeout isolation matters.
  • Repository license metadata is marked NOASSERTION; check the repository’s license terms before adopting or redistributing it.
  • The project is active, with recent commits and releases and contributors across the project; its issue closure figures are capped, so they should not be read as a complete count.

Found this useful?

Share it with someone who would like rq.

Comparisons