z4j-rqscheduler

The rq-scheduler adapter for z4j.

Surfaces rq-scheduler periodic / interval / cron jobs on the dashboard's Schedules page, read, trigger, disable (cancel), delete.

Compatibility

• rq-scheduler 0.11+ (no upper cap)
• Python 3.11+

Full per-adapter matrix at https://z4j.dev/reference/compatibility/.

What it ships

Schedule create and update are not yet supported from the dashboard for rq-scheduler, so the brain greys those actions out. Define schedules in your project's Python entrypoint (scheduler.cron(...) / scheduler.schedule(...)); z4j surfaces them read-only once they exist.

Install

pip install z4j-rq z4j-rqscheduler

from rq import Queue
from rq_scheduler import Scheduler
from redis import Redis
from z4j_bare import install_agent
from z4j_rq import RqEngineAdapter
from z4j_rqscheduler import RqSchedulerAdapter

redis = Redis(host="localhost")
queue = Queue(connection=redis)
scheduler = Scheduler(queue=queue, connection=redis)

install_agent(
    engines=[RqEngineAdapter(rq_app=queue)],
    schedulers=[RqSchedulerAdapter(scheduler=scheduler)],
    brain_url="https://brain.example.com",
    token="z4j_agent_...",
    project_id="my-project",
)

Pairs with

• z4j-rq, engine adapter

Reliability

• No exception from the adapter ever propagates back into rq-scheduler or your job code.
• Schedule writes to Redis are atomic; if z4j is unreachable, the local Redis write is never affected.

Documentation

Full docs at z4j.dev/schedulers/rq-scheduler/.

License

Apache-2.0, see LICENSE.

Links

• Homepage: https://z4j.com
• Documentation: https://z4j.dev
• PyPI: https://pypi.org/project/z4j-rqscheduler/
• Issues: https://github.com/z4jdev/z4j-rqscheduler/issues
• Changelog: CHANGELOG.md
• Security: security@z4j.com (see SECURITY.md)