Django

z4j-django · Upstream project

Django AppConfig integration, zero boilerplate.

Adds z4j as a Django app. Reads DATABASES + CELERY_* from your settings, auto-registers with django_celery_beat for schedule CRUD, plays nice with django-celery-results for state. System checks warn when your setup drifts.

Install

bash

pip install z4j-django[celery]

Wire it in

python

# settings.py
INSTALLED_APPS = [
    *existing_apps,
    "z4j_django",
]

Z4J_BRAIN_URL = "https://brain.example.com"
Z4J_TOKEN = env("Z4J_TOKEN")
Z4J_HMAC_SECRET = env("Z4J_HMAC_SECRET")

What you get

Django-specific features

Django AppConfig auto-registration

django_celery_beat schedule adapter

System checks for misconfiguration

Signal-handler events (lossless during restarts)

CSRF-safe admin integration

Engine pairings

Django works with every z4j engine

The framework adapter handles lifecycle and config. Any engine adapter slots in alongside.

Celery

Celery

The industry standard, covered end-to-end.

RQ

Lightweight Redis queue, fully instrumented.

Dramatiq

Dramatiq

Middleware-driven Dramatiq observability.

Huey

Huey

Lightweight Redis/SQLite queue, first-class.

arq

arq

Async Redis queue for FastAPI-era Python.

taskiq

taskiq

Broker-agnostic async task framework.

Other platforms

See also

Flask

Flask

Flask extension pattern. One line to install.

FastAPI

FastAPI

Lifespan-hook integration for async stacks.

Get started with z4j + Django

Install z4j Django docs