Skip to main content
FastAPI + RQ . Self-hosted . Open source

FastAPI RQ Dashboard

Run RQ inside a FastAPI app and you have working background jobs. Run RQ 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.

FastAPI + RQ works the same way every other FastAPI + queue combo works under z4j: pip install the framework adapter with the engine extra, set four environment variables, restart your worker. z4j stays where you put it (homelab, on-prem, or cloud); the agent always reaches out.

Install z4j FastAPI integration details RQ adapter details
install

Install z4j alongside FastAPI + RQ

1. Install the brain

bash 
pip install z4j && z4j serve

First 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

bash 
pip install z4j-fastapi[rq]

3. Wire it into FastAPI

python 
from fastapi import FastAPI
from z4j_fastapi import z4j_lifespan

app = FastAPI(lifespan=z4j_lifespan())

What you get

  • Persistent RQ task history in Postgres or SQLite
  • Adapter-advertised controls: submit_task, retry_task, cancel_task, bulk_retry, purge_queue, requeue_dead_letter
  • Scheduler integration via rq scheduler; available controls depend on that scheduler adapter
  • RBAC with invitations and password reset
  • HMAC-chained tamper-evident audit log
  • Notifications: email, Slack, Telegram, webhook
License

z4j-fastapi and z4j-rq 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.

RQ actions exposed

What the dashboard can actually do

Native actions

  • submit_task
  • retry_task
  • cancel_task
  • bulk_retry
  • purge_queue
  • requeue_dead_letter

Event capture

Worker-wrap monkey-patch plus per-job callbacks. No code changes required in your jobs.

Reconciliation

rq.job.Job: status + ended_at + exc_info from the Redis hash.

other FastAPI stacks

FastAPI with a different engine

FastAPI +

FastAPI Celery Dashboard

The industry standard, covered end-to-end.
FastAPI +

FastAPI Dramatiq Dashboard

Middleware-driven Dramatiq observability.
FastAPI +

FastAPI Huey Dashboard

Lightweight Redis/SQLite queue, first-class.
FastAPI +

FastAPI arq Dashboard

Async Redis queue for FastAPI-era Python.
FastAPI +

FastAPI taskiq Dashboard

Broker-agnostic async task framework.
RQ on other frameworks

Same engine, different framework

+ RQ

Django RQ Dashboard

Django AppConfig integration, zero boilerplate.
+ RQ

Flask RQ Dashboard

Flask extension pattern. One line to install.

Start using FastAPI RQ Dashboard

Self-hosted, open source, no SaaS, no telemetry. z4j runs anywhere Python or Docker runs.

Install z4j Read the docs