FastAPI Huey Dashboard
Run Huey inside a FastAPI app and you have working background jobs. Run Huey with z4j and you also have a dashboard, persistent history, the task controls this adapter can execute safely, scheduler integration, RBAC with invitations, and a tamper-evident audit log. z4j is one container or one Python process; the agent is one pip extra in your existing FastAPI venv.
Huey is the simplest of the bunch: small surface, no result backend by default, file-backed scheduler optional. FastAPI + Huey + z4j gives you a dashboard for a stack that traditionally has none, safe submit, replacement-input retry, and pending-only revoke controls, plus an audit log for operator actions. Revoke prevents pending work from starting; it does not interrupt running work.
Install z4j alongside FastAPI + Huey
1. Install the brain
pip install z4j && z4j serveFirst boot prints a setup URL to stderr. Open it, create the first admin, and mint a token + HMAC secret for this agent.
2. Add the agent to your FastAPI venv
pip install z4j-fastapi[huey]3. Wire it into FastAPI
from fastapi import FastAPI
from z4j_fastapi import z4j_lifespan
app = FastAPI(lifespan=z4j_lifespan())What you get
- Persistent Huey task history in Postgres or SQLite
- Adapter-advertised controls: submit_task, retry_task (complete replacement inputs), cancel_task (pending revoke only)
- Scheduler integration via huey periodic; available controls depend on that scheduler adapter
- RBAC with invitations and password reset
- HMAC-chained tamper-evident audit log
- Notifications: email, Slack, Telegram, webhook
z4j-fastapi and z4j-huey are Apache 2.0. Importing them into your FastAPI app does not affect your application's licensing. z4j is AGPL-3.0-or-later, isolated in its own process.
What the dashboard can actually do
Native actions
-
submit_task -
retry_task (complete replacement inputs) -
cancel_task (pending revoke only)
Event capture
huey.signals decorator, installed via adapter.connect_signals().
Reconciliation
Huey result store (peek_data). Returns pending/success/unknown.
FastAPI with a different engine
FastAPI Celery Dashboard
The industry standard, covered end-to-end.
FastAPI RQ Dashboard
Lightweight Redis queue, fully instrumented.
FastAPI Dramatiq Dashboard
Middleware-driven Dramatiq observability.
FastAPI arq Dashboard
Async Redis queue for FastAPI-era Python.
FastAPI taskiq Dashboard
Broker-agnostic async task framework.
Same engine, different framework
Start using FastAPI Huey Dashboard
Self-hosted, open source, no SaaS, no telemetry. z4j runs anywhere Python or Docker runs.