Huey

v1.13.0 Apache-2.0

Lightweight Redis/SQLite queue, first-class.

Supports Huey 2.4 and newer, including Huey 3. Event capture uses huey.signals. cancel_task calls revoke_by_id to prevent pending work from starting; it never interrupts running work. Pair with z4j-hueyperiodic to surface @periodic_task schedules.

Docs PyPI: z4j-huey Source Upstream

Latest: v1.13.0
Released: 2026-10-19
License: Apache-2.0

Install

bash

pip install z4j-huey

Native actions

submit_task
retry_task (complete replacement inputs)
cancel_task (pending revoke only)

Not supported

running-task cancellation
bulk_retry
requeue_dead_letter
list_dead_letters
purge_queue
restart_worker
rate_limit

These are engine-level limitations: the underlying engine does not expose the primitives required to support these actions.

Wiring

How z4j plugs in

Event capture

huey.signals decorator, installed via adapter.connect_signals().

Reconciliation

Huey result store (storage.peek_data via get_raw). Returns success, failure or unknown.

Paired scheduler

Huey @periodic_task

Manage code-defined Huey schedules with durable overrides.

z4j-hueyperiodic

Manages Huey crontab definitions through a private persistent override file consumed by the actual periodic consumer. Dashboard changes do not rewrite Python code.

Learn more

More engines