arq

Spec sheet

What it does

arq provides job queues and RPC in Python using asyncio and Redis.Read 9 Oct 2026 · arq-docs.helpmanual.io

Purpose

arq provides job queues and RPC in Python using asyncio and Redis.Read 9 Oct 2026 · arq-docs.helpmanual.io

License

The PyPI project page lists the MIT License.Read 9 Oct 2026 · pypi.org

Async execution

It uses asyncio to enqueue and execute jobs without blocking and can run multiple jobs concurrently as asyncio tasks.Read 9 Oct 2026 · arq-docs.helpmanual.io

Blocking work

The docs recommend running functions that block the event loop for extended periods in a ThreadPoolExecutor or ProcessPoolExecutor.Read 9 Oct 2026 · arq-docs.helpmanual.io

Concurrency

It uses asyncio Tasks to run multiple jobs simultaneously, potentially hundreds.Read 9 Oct 2026 · arq-docs.helpmanual.io

Current version

The documentation lists v0.28.0 as the current version.Read 9 Oct 2026 · arq-docs.helpmanual.io

Distribution

PyPI provides arq as a source distribution and a platform-independent Python 3 wheel.Read 9 Oct 2026 · pypi.org

Execution behavior

If a worker shuts down during a job, the job remains queued to run again, so jobs may be called more than once and should tolerate repetition.Read 9 Oct 2026 · arq-docs.helpmanual.io

Install

The documentation says to install arq with `pip install arq`.Read 9 Oct 2026 · arq-docs.helpmanual.io

Installation

The documentation gives `pip install arq` as the installation command.Read 9 Oct 2026 · arq-docs.helpmanual.io

Intended audience

PyPI classifies the project for developers, information technology, and system administrators.Read 9 Oct 2026 · pypi.org

Job results

The Job instance can provide job information, status, and results.Read 9 Oct 2026 · arq-docs.helpmanual.io

Job uniqueness

Custom job IDs prevent a job with that ID from being enqueued again until its execution finishes and its result clears.Read 9 Oct 2026 · arq-docs.helpmanual.io

Maintenance status

The PyPI project page says arq is in maintenance only mode.Read 9 Oct 2026 · pypi.org

Project author

PyPI credits Samuel Colvin as the author.Read 9 Oct 2026 · pypi.org

Python requirement

The PyPI project page lists Python >=3.9 as required.Read 9 Oct 2026 · pypi.org

Redis connection

The docs say the default Redis connection is localhost:6379 with no password.Read 9 Oct 2026 · arq-docs.helpmanual.io

Redis dependency

arq uses Redis; the documented default connection is localhost:6379 with no password.Read 9 Oct 2026 · arq-docs.helpmanual.io

Retries

Jobs can be retried, including by raising the Retry exception from within a job.Read 9 Oct 2026 · arq-docs.helpmanual.io

Scheduling

Jobs can be deferred until a specified time or duration, and functions can be scheduled as cron jobs.Read 9 Oct 2026 · arq-docs.helpmanual.io

Scheduling and retries

Jobs can be deferred until a duration or specific time, and jobs can be retried.Read 9 Oct 2026 · arq-docs.helpmanual.io

Uniqueness

Custom job IDs can prevent a job from being enqueued again while its execution is unfinished and its result remains available.Read 9 Oct 2026 · arq-docs.helpmanual.io

Where Specifiction places it

• Task Queue Software#19 of 377.7