https://github.com/z4jdev/z4j-rq
z4j RQ queue engine adapter (Apache 2.0)
https://github.com/z4jdev/z4j-rq
agent apache-2-0 python redis-queue rq task-queue z4j
Last synced: 12 days ago
JSON representation
z4j RQ queue engine adapter (Apache 2.0)
- Host: GitHub
- URL: https://github.com/z4jdev/z4j-rq
- Owner: z4jdev
- License: apache-2.0
- Created: 2026-04-22T16:13:09.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-03T06:01:24.000Z (25 days ago)
- Last Synced: 2026-05-03T08:33:52.544Z (25 days ago)
- Topics: agent, apache-2-0, python, redis-queue, rq, task-queue, z4j
- Language: Python
- Homepage: https://pypi.org/project/z4j-rq/
- Size: 71.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# z4j-rq
[](https://pypi.org/project/z4j-rq/)
[](https://pypi.org/project/z4j-rq/)
[](https://github.com/z4jdev/z4j-rq/blob/main/LICENSE)
The RQ engine adapter for [z4j](https://z4j.com).
Streams every RQ job lifecycle event from your workers to z4j
and accepts operator control actions from the dashboard. Pair with
z4j-rqscheduler to manage periodic schedules.
## What it ships
| Capability | Notes |
|---|---|
| Job lifecycle events | enqueued, started, finished, failed, deferred, scheduled |
| Job discovery | runtime registry of queue names + worker introspection |
| Submit / retry / cancel | direct against the RQ queue |
| Bulk retry | filter-driven; re-enqueues matching jobs from the failed registry |
| Purge queue | with confirm-token guard |
| Reconcile task | via Redis-backed job hash lookup |
## Install
```bash
pip install z4j-rq z4j-rqscheduler
```
Pair with a framework adapter:
```bash
pip install z4j-django z4j-rq z4j-rqscheduler # Django
pip install z4j-flask z4j-rq z4j-rqscheduler # Flask
pip install z4j-fastapi z4j-rq z4j-rqscheduler # FastAPI
pip install z4j-bare z4j-rq z4j-rqscheduler # framework-free worker
```
## Pairs with
- [`z4j-rqscheduler`](https://github.com/z4jdev/z4j-rqscheduler), schedule adapter for rq-scheduler
## Reliability
- No exception from the adapter ever propagates back into your RQ
workers or job hooks.
- Events buffer locally when z4j is unreachable; workers never
block on network I/O.
## Documentation
Full docs at [z4j.dev/engines/rq/](https://z4j.dev/engines/rq/).
## License
Apache-2.0, see [LICENSE](LICENSE).
## Links
- Homepage: https://z4j.com
- Documentation: https://z4j.dev
- PyPI: https://pypi.org/project/z4j-rq/
- Issues: https://github.com/z4jdev/z4j-rq/issues
- Changelog: [CHANGELOG.md](CHANGELOG.md)
- Security: security@z4j.com (see [SECURITY.md](SECURITY.md))