NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1903 most downloaded on PyPI
Job queues in python with asyncio and redis
Latest stable
0.28.0
Last release 7 months ago
16 Apr 2026
Release timing varies
gaps range from 2 weeks to 1.3 years
Most releases are documented
notes for 49 of 55 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
65 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Add support for Python 3.14 by @Viicos in #522
Full Changelog: https://github.com/python-arq/arq/compare/v0.27.0...v0.28.0
Add support for Python 3.13, remove advertised support for Python 3.8 by @Viicos in #514
Your coding agent can read these notes before it upgrades. Set up the MCP server →
retry_on_error type annotation by @armicron in #446Retry docstring by @PassionateBytes in #507Full Changelog: v0.26.3...v0.27.0
retry_on_error type annotation by @armicron in https://github.com/python-arq/arq/pull/446Retry docstring by @PassionateBytes in https://github.com/python-arq/arq/pull/507Full Changelog: https://github.com/python-arq/arq/compare/v0.26.3...v0.27.0
Fix wrong reference in Retry docstring by @PassionateBytes in #507
Fix retry_on_error type annotation by @armicron in #446
Add support for Python 3.13, remove advertised support for Python 3.8 by @Viicos in #514
Fix negative expires_ms and avoid worker freezing while using cron by @Matvey-Kuk in https://github.com/python-arq/arq/pull/479
Full Changelog: https://github.com/python-arq/arq/compare/v0.26.2...v0.26.3
Fix negative expires_ms and avoid worker freezing while using cron by @Matvey-Kuk in #479
Fix race condition on task retry by @RB387 in #487
Uses testcontainers to provide a redis instance for the unit tests by @chrisguidry in #470
testcontainers to provide a redis instance for the unit tests by @chrisguidry in #470Full Changelog: v0.26.0...v0.26.1
testcontainers to provide a redis instance for the unit tests by @chrisguidry in https://github.com/python-arq/arq/pull/470Full Changelog: https://github.com/python-arq/arq/compare/v0.26.0...v0.26.1
No changes since v0.26.0b1 . Full Changelog : v0.26.0b1...v0.26.0
No changes since v0.26.0b1.
Full Changelog: v0.26.0b1...v0.26.0
Prevent worker getting stuck in terminating state by @JonasKs in #370
max_connections to be set in RedisSettings by @danbox in #406RedisSettings explanation in main_demo.py by @RamonGiovane in #422Full Changelog: v0.25.0...v0.26.0b1
max_connections to be set in RedisSettings by @danbox in https://github.com/samuelcolvin/arq/pull/406RedisSettings explanation in main_demo.py by @RamonGiovane in https://github.com/samuelcolvin/arq/pull/422Full Changelog: https://github.com/samuelcolvin/arq/compare/v0.25.0...v0.26.0b1
Allow to opt-out from logging results by @iamlikeme in #352
after_job_end hook by @AngellusMortis in #355ResultNotFound when Job.result() finds no job and no result by @iamlikeme in #3643.11 for testing #367Full Changelog: https://github.com/samuelcolvin/arq/compare/v0.24.0...v0.25.0
Allow customisation of timezone in logs, #281
username option to RedisSettings, #299main, 40c8803--custom-log-dict CLI option, #294_expires in enqueue_job, #313unix_socket_path in RedisSettings, #336info command to support Redis 6.2.3, #338setup.py to pyproject.toml, #341abort for deferred jobs, #307Full Changelog: https://github.com/samuelcolvin/arq/compare/v0.23a1...v0.24.0
No changes from v0.23a1 .
No changes from v0.23a1.
Fix jobs timeout by @kiriusm2 in #248
index.rst by @Kludex in #266on_job_start and on_job_end hooks by @tobymao in #274job_id on cron jobs by @JonasKs in #293fix package importing in example, #261, thanks @cdpath
aioredis to <2.0.0 (soon we'll support aioredis>=2.0.0), #258, thanks @PaxPrz* CI improvements #243 * fix log_redis_info #255
log_redis_info #255Added queue_name attribute to JobResult, #198
queue_name attribute to JobResult, #198job_deserializer, job_serializer and default_queue_name on worker pools to better supported
nested jobs, #203, #215 and #218cron jobs to prevent duplicate jobs, #200CancelledError in python 3.8+, #213pole_delay and use correct spelling poll_delay, #242fix timestamp issue in _defer_until without timezone offset, #182
fix timestamp issue in _defer_until without timezone offset, #182
add option to disable signal handler registration from running inside other frameworks, #183
add default_queue_name to create_redis_pool and ArqRedis, #191
Worker can retrieve the queue_name from the connection pool, if present
fix potential race condition when starting jobs, #194
support python 3.9 and pydantic 1.7, #214
fix concurrency with multiple workers, #180
Python 3.8 support, #178
fix concurrency with multiple workers, #180
full mypy coverage, #181
Add py.typed file to tell mypy the package has type hints, #163
Add py.typed file to tell mypy the package has type hints, #163
Added ssl option to RedisSettings, #165
Include queue_name when for job object in response to enqueue_job, #160
Include queue_name when for job object in response to enqueue_job, #160
Fix cron scheduling on a specific queue, by @dmvass and @Tinche
Fix cron scheduling on a specific queue, by @dmvass and @Tinche
add support for Redis Sentinel fix #132
add support for Redis Sentinel fix #132
fix Worker.abort_job invalid expire time error, by @dmvass
fix usage of max_burst_jobs, improve coverage fix #152
fix usage of max_burst_jobs, improve coverage fix #152
stop lots of WatchVariableError errors in log, #153
deal better with failed job deserialization, #149 by @samuelcolvin
deal better with failed job deserialization, #149 by @samuelcolvin
fix run_check(xmax_burst_jobs=...) when a jobs fails, #150 by @samuelcolvin
add worker.queue_read_limit, fix #141, by @rubik
add worker.queue_read_limit, fix #141, by @rubik
custom serializers, eg. to use msgpack rather than pickle, #143 by @rubik
add ArqRedis.queued_jobs utility method for getting queued jobs while testing, fix #145 by @samuelcolvin
prevent duplicate job_id when job result exists, fix #137
prevent duplicate job_id when job result exists, fix #137
add "don't retry mode" via worker.retry_jobs = False, fix #139
add worker.max_burst_jobs
improved error when a job is aborted (eg. function not found)
improved error when a job is aborted (eg. function not found)
fix semaphore on worker with many expired jobs
fix semaphore on worker with many expired jobs
add support for different queues, #127 thanks @tsutsarin
add support for different queues, #127 thanks @tsutsarin
use dicts for pickling not tuples, better handling of pickling errors, #123
use dicts for pickling not tuples, better handling of pickling errors, #123
catch any error when pickling job result
pipeline in enqueue_job* add Worker.run_check, fix #115
add Worker.run_check, fix #115
fix Worker with custom redis settings
fix Worker with custom redis settings
add job_try argument to enqueue_job, #113
add job_try argument to enqueue_job, #113
adding --watch mode to the worker (requires watchgod), #114
allow ctx when creating Worker
add all_job_results to ArqRedis
fix python path when starting worker
Breaking Change: COMPLETE REWRITE!!! see docs for details, #110
Breaking Change: COMPLETE REWRITE!!! see docs for details, #110
Nothing published for this version
reconfigure Job, return a job instance when enqueuing tasks #93
update dependencies
reconfigure Job, return a job instance when enqueuing tasks #93
tweaks to docs #106
package updates, particularly compatibility for msgpack 0.5.6
package updates, particularly compatibility for msgpack 0.5.6
Breaking Change: integration with aioredis >= 1.0, basic usage hasn't changed but look at aioredis's migration docs for changes in redis API #76
Breaking Change: integration with aioredis >= 1.0, basic usage hasn't changed but look at aioredis's migration docs for changes in redis API #76
better signal handling, support uvloop #73
better signal handling, support uvloop #73
drain pending tasks and drain task cancellation #74
add aiohttp and docker demo /demo #75
extract create_pool_lenient from RedixMixin
extract create_pool_lenient from RedixMixin
improve redis connection traceback
add create_connection_timeout to connection pool
RedisSettings repr method
add create_connection_timeout to connection pool
fix bug with RedisMixin.get_redis_pool creating multiple queues
fix bug with RedisMixin.get_redis_pool creating multiple queues
tweak drain logs
only save job on task in drain if re-enqueuing
only save job on task in drain if re-enqueuing
add semaphore timeout to drains
add key count to log_redis_info
correct format of log_redis_info
correct format of log_redis_info
log redis version when starting worker, fix #64
log redis version when starting worker, fix #64
log "connection success" when connecting to redis after connection failures, fix #67
add job ids, for now they're just used in logging, fix #53
Breaking change: switch to_unix_ms to just return the timestamp int, add to_unix_ms_tz to return tz offset too
allow set encoding in msgpack for jobs #49
cron tasks allowing scheduling of functions in the future #50
Breaking change: switch to_unix_ms to just return the timestamp int, add to_unix_ms_tz to return tz offset too
* uprev setup requires * correct setup arguments
uprev setup requires
correct setup arguments
use async-timeout around shadow_factory
add async-timeout dependency
use async-timeout around shadow_factory
change logger name for control process log messages
use Semaphore rather than asyncio.wait(...return_when=asyncio.FIRST_COMPLETED) for improved performance
improve log display
add timeout and retry logic to RedisMixin.create_redis_pool
implementing reusable Drain which takes tasks from a redis list and allows them to be execute asynchronously.
implementing reusable Drain which takes tasks from a redis list and allows them to be execute asynchronously.
Drain uses python 3.6 async yield, therefore python 3.5 is no longer supported.
prevent repeated identical health check log messages
* mypy at last passing, #30 * adding trove classifiers, #29
mypy at last passing, #30
adding trove classifiers, #29
add StopJob exception for cleaning ending jobs, #21
add StopJob exception for cleaning ending jobs, #21
add flushdb to MockRedis, #23
allow configurable length job logging via log_curtail on Worker, #28
add shadow_kwargs method to BaseWorker to make customising actors easier.
add shadow_kwargs method to BaseWorker to make customising actors easier.
reimplement worker reuse as it turned out to be useful in tests.
reimplement worker reuse as it turned out to be useful in tests.
see HISTORY.rst
see HISTORY.rst
use gather rather than wait for startup and shutdown so exceptions propagate.
add --check option to confirm arq worker is running.
fix issue with Concurrent class binding with multiple actor instances.
fix issue with Concurrent class binding with multiple actor instances.
improving naming of log handlers and formatters
improving naming of log handlers and formatters
upgrade numerous packages, nothing significant
add startup and shutdown methods to actors
switch @concurrent to return a Concurrent instance so the direct method is accessible via <func>.direct
improved solution for preventing new jobs starting when the worker is about to stop
improved solution for preventing new jobs starting when the worker is about to stop
switch SIGRTMIN > SIGUSR1 to work with mac
fix main process signal handling so the worker shuts down when just the main process receives a signal
fix main process signal handling so the worker shuts down when just the main process receives a signal
re-enqueue un-started jobs popped from the queue if the worker is about to exit
rename settings class to RedisSettings and simplify significantly
rename settings class to RedisSettings and simplify significantly
add concurrency_enabled argument to aid in testing
changes:
concurrency_enabled argument to aid in testingprevent logs disabling other logs
prevent logs disabling other logs
* first proper release
first proper release
One column per quarter.