Huey

v1.12.1 Apache-2.0

Lightweight Redis/SQLite queue, first-class.

Supports Huey 2.4 and newer, below 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.12.1
Released: 2026-10-05
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 (peek_data). Returns pending/success/unknown.

Paired scheduler

Huey @periodic_task

Read-only surface for Huey's decorator schedules.

z4j-hueyperiodic

Huey's @periodic_task is decorator-defined in source code, read-only at runtime. This adapter surfaces every periodic on the Schedules page for visibility and monitoring.

Learn more

More engines