pydocket
A distributed background task system for Python functions
Decision gist · record as of 2026-08-14
Yes, if you need a lightweight, type-aware background task queue with integrated scheduling. Active maintenance (released 4 days ago), permissive MIT license, low install friction, and zero known vulnerabilities make it a solid choice. Requires Python 3.10+ and Redis 5.0.0+ or in-memory backend for testing. Small dependency footprint and focus on simplicity are strengths if you want to avoid heavier frameworks.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or above and a Redis server with Streams support (Redis 5.0.0+, Valkey 8.1+, or in-memory burner-redis for testing).
- Low install friction with a pure-Python wheel.
- Active maintenance—released 4 days ago with a last commit on 2026-08-12.
License · maintenance · safety
permissive license (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for commercial and proprietary projects.
last release 2026-08-10 (4 days) · last repo commit 2026-08-12 · 142 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 17,178,652 downloads/mo, #1,129 on PyPI
Alternatives
Verify before relying
pip install pydocket
from pydocket import Docket
from datetime import datetime, timedelta, timezone
async def greet(name: str) -> None:
print(f"Hello, {name}!")
async with Docket() as docket:
await docket.add(greet)("Jane")
soon = datetime.now(timezone.utc) + timedelta(seconds=3)
await docket.add(greet, when=soon)("John")- Whether the package handles task retries, dead-letter queues, or failure callbacks.
- Scalability limits or performance characteristics under high task volume.
- Whether dependency injection support is fully documented with examples.
What it is and what it does
Pydocket is a distributed background task queue built on Redis streams for Python async functions. It lets you queue work to run immediately or at a specific future time using the same simple interface: call `add(function, when=optional_datetime)(args)`. A Worker process pulls tasks from the queue and executes them, with full type hints and dependency injection support.
The package targets Python 3.10+ and requires a Redis server (tested with 6.2, 7.4, 8.6, or Valkey 8.1). For local testing, you can use an in-memory backend via burner-redis without a real Redis instance. It depends on redis, cloudpickle, typer, rich, prometheus-client, opentelemetry-api, and several utility libraries for scheduling, logging, and async task management.
Use it for
- Queue email or notification sends to run asynchronously without blocking the main request.
- Schedule data processing jobs to run at specific times without deploying cron jobs.
- Skip or retry problematic tasks by updating the queue without redeploying code.
- Monitor background work with prometheus-client metrics and opentelemetry-api tracing.
- Test async task logic in isolation using the in-memory backend without Redis.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a lightweight, type-aware background task queue with integrated scheduling.
Active maintenance (released 4 days ago), permissive MIT license, low install friction, and zero known vulnerabilities make it a solid choice. Requires Python 3.10+ and Redis 5.0.0+ or in-memory backend for testing. Small dependency footprint and focus on simplicity are strengths if you want to avoid heavier frameworks.
Install
pydocket on PyPI
Before you install
Low install friction with a pure-Python wheel. Active maintenance—released 4 days ago with a last commit on 2026-08-12. Requires Redis 5.0.0+ or can use an in-memory backend via burner-redis for testing.
Requires Python 3.10 or above and a Redis server with Streams support (Redis 5.0.0+, Valkey 8.1+, or in-memory burner-redis for testing).
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for commercial and proprietary projects.
Quickstart
pip install pydocket
from pydocket import Docket
from datetime import datetime, timedelta, timezone
async def greet(name: str) -> None:
print(f"Hello, {name}!")
async with Docket() as docket:
await docket.add(greet)("Jane")
soon = datetime.now(timezone.utc) + timedelta(seconds=3)
await docket.add(greet, when=soon)("John")Verify before relying
- Whether the package handles task retries, dead-letter queues, or failure callbacks.
- Scalability limits or performance characteristics under high task volume.
- Whether dependency injection support is fully documented with examples.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 15 packagesburner-rediscloudpicklecronsimexceptiongroupopentelemetry-apiprometheus-clientpy-key-value-aiopython-json-loggerredisrichtaskgrouptypertyping-extensionstzdatauncalled-for |
| Maintenance | Actively maintained 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 17,178,652 / month, #1,129 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Typing :: Typed |
Evidence: pydocket-0.24.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “background task queue redis”
- pydocketDocket is a distributed background task system that queues Python…
- django-rqDjango-RQ integrates RQ (Redis Queue) with Django, allowing you to…
- arqarq provides a job queue system for Python that uses asyncio and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Distributed Computing packages
gRPC Python is an HTTP/2-based RPC framework that enables you to define and call remote procedures across network boundaries using protocol buffers for serialization.
Install it if you need RPC communication in a distributed system or are integrating with existing gRPC services.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
Cloudpickle extends Python's standard pickle module to serialize lambda functions, interactively-defined functions and classes, and other constructs that the default pickle cannot handle, making it suitable for cluster computing and remote code execution.
Install it if you need to serialize lambda functions, interactively-defined code, or non-standard Python constructs for cluster computing or distributed execution.
Provides a unified, open()-compatible Python API for streaming large files from remote storage (S3, GCS, Azure, HDFS, SFTP, HTTP) and local filesystems, with transparent compression support.
Install it if you work with large files on cloud storage or remote systems and want to avoid writing boilerplate around multiple SDKs.
Portalocker provides cross-platform file locking with support for exclusive and shared locks, plus Redis-based distributed locks and process-aware PID file locking.
Install it if you need file or process coordination; the optional extras (pywin32, redis) are only required for specific lock types.
Ray is a distributed computing framework that scales Python applications from a single machine to multi-node clusters, providing abstractions for parallel tasks, stateful actors, and shared objects.
See also arq · hatchet-sdk · huey · doit · gen-worker · rq-scheduler · dramatiq · taskiq-redis · rq · upstash-redis