Docket is a distributed background task system for Python functions with a focus on the scheduling of future work as seamlessly and efficiently as immediate work.
At a glance
from datetime import datetime, timedelta, timezone
from docket import Docket
async def greet(name: str, greeting="Hello") -> None:
print(f"{greeting}, {name} at {datetime.now()}!")
async with Docket() as docket:
await docket.add(greet)("Jane")
now = datetime.now(timezone.utc)
soon = now + timedelta(seconds=3)
await docket.add(greet, when=soon)("John", greeting="Howdy")
from docket import Docket, Worker
async with Docket() as docket:
docket.register(greet)
async with Worker(docket) as worker:
await worker.run_until_finished()
Hello, Jane at 2025-03-05 13:58:21.552644!
Howdy, John at 2025-03-05 13:58:24.550773!
Check out our docs for more details, examples, and the API reference.
Why docket?
⚡️ Snappy one-way background task processing without any bloat
📅 Schedule immediate or future work seamlessly with the same interface
⏭️ Skip problematic tasks or parameters without redeploying
🌊 Purpose-built for Redis streams
🧩 Fully type-complete and type-aware for your background task functions
💉 Dependency injection like FastAPI, Typer, and FastMCP for reusable resources
Installing docket
Docket is available on PyPI under the package name
pydocket. It targets Python 3.10 or above.
With uv:
uv pip install pydocket
or
uv add pydocket
With pip:
pip install pydocket
Docket requires a Redis server with Streams support (which was introduced in Redis 5.0.0). Docket is tested with:
- Redis 6.2, 7.4, and 8.6 (standalone and cluster modes)
- Valkey 8.1
- In-memory backend via burner-redis for testing
For testing without Redis, use the in-memory backend:
from docket import Docket
async with Docket(name="my-docket", url="memory://my-docket") as docket:
# Use docket normally - all operations are in-memory
...
See Testing with Docket for more details.
Hacking on docket
We use uv for project management, so getting set up
should be as simple as cloning the repo and running:
uv sync
The to run the test suite:
pytest
We aim to maintain 100% test coverage, which is required for all PRs to docket. We
believe that docket should stay small, simple, understandable, and reliable, and that
begins with testing all the dusty branches and corners. This will give us the
confidence to upgrade dependencies quickly and to adapt to new versions of Redis over
time.
To work on the documentation locally:
uv sync
uv run zensical serve
This will start a local preview server. The docs are built with
Zensical and configured in mkdocs.yml.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pydocket-0.24.1.tar.gz.
File metadata
- Download URL: pydocket-0.24.1.tar.gz
- Upload date:
- Size: 430.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
477d77be1fcfd10ee0c2d0b8aa8c6e97851b9c7f39bb6f2b4e6d42e9b4d6e95a
|
|
| MD5 |
777b3668fdb14ade335b27469ba8fb4f
|
|
| BLAKE2b-256 |
b76ba87c6e3fd197807f630af4270aa2ce8f4c1fca4e43bba783f273d298d646
|
Provenance
The following attestation bundles were made for pydocket-0.24.1.tar.gz:
Publisher:
publish.yml on chrisguidry/docket
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pydocket-0.24.1.tar.gz -
Subject digest:
477d77be1fcfd10ee0c2d0b8aa8c6e97851b9c7f39bb6f2b4e6d42e9b4d6e95a - Sigstore transparency entry: 2412131593
- Sigstore integration time:
-
Permalink:
chrisguidry/docket@e3687d4d86d281b95d99752317e981d75debd901 -
Branch / Tag:
refs/tags/0.24.1 - Owner: https://github.com/chrisguidry
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@e3687d4d86d281b95d99752317e981d75debd901 -
Trigger Event:
release
-
Statement type:
File details
Details for the file pydocket-0.24.1-py3-none-any.whl.
File metadata
- Download URL: pydocket-0.24.1-py3-none-any.whl
- Upload date:
- Size: 130.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1faa6c3d566f1f0431e35dfa12db4ccee515d945b913b516ee3e6279afb9e789
|
|
| MD5 |
c4c246e5e96d0d7ed374628824b0545f
|
|
| BLAKE2b-256 |
a7054e3b902bc0ca407188aa5fe38af49be634487aec242a77287103242e11b2
|
Provenance
The following attestation bundles were made for pydocket-0.24.1-py3-none-any.whl:
Publisher:
publish.yml on chrisguidry/docket
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pydocket-0.24.1-py3-none-any.whl -
Subject digest:
1faa6c3d566f1f0431e35dfa12db4ccee515d945b913b516ee3e6279afb9e789 - Sigstore transparency entry: 2412131946
- Sigstore integration time:
-
Permalink:
chrisguidry/docket@e3687d4d86d281b95d99752317e981d75debd901 -
Branch / Tag:
refs/tags/0.24.1 - Owner: https://github.com/chrisguidry
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@e3687d4d86d281b95d99752317e981d75debd901 -
Trigger Event:
release
-
Statement type:
