Skip to main content
Huey logo

Huey

v1.0 (new)

z4j-huey · Upstream project

Lightweight Redis/SQLite queue, first-class.

Huey 2.x and 3.x both supported. Event capture via huey.signals (enqueued / executing / complete / error / retried / revoked). Pair with z4j-hueyperiodic to surface @periodic_task schedules.

Install

bash
pip install z4j-huey

Native actions

  • submit_task
  • retry_task
  • cancel_task

Brain-polyfilled actions

  • bulk_retry
  • requeue_dead_letter

The brain fetches the original args from its tasks table and lowers to submit_task transparently. The dashboard shows the same button regardless.

Not supported

  • purge_queue (engine limitation)
  • restart_worker (graceful self-exit)
  • rate_limit

Engine-level limitations, not a roadmap gap. These actions require primitives the engine does not expose.

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

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

Other z4j engines

Try z4j with Huey