https://github.com/z4jdev/z4j-arq
z4j arq queue engine adapter (Apache 2.0)
https://github.com/z4jdev/z4j-arq
Last synced: 16 days ago
JSON representation
z4j arq queue engine adapter (Apache 2.0)
- Host: GitHub
- URL: https://github.com/z4jdev/z4j-arq
- Owner: z4jdev
- License: apache-2.0
- Created: 2026-05-04T03:12:35.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-23T15:58:19.000Z (20 days ago)
- Last Synced: 2026-06-23T17:30:03.762Z (20 days ago)
- Language: Python
- Homepage: https://pypi.org/project/z4j-arq/
- Size: 34.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# z4j-arq
[](https://pypi.org/project/z4j-arq/)
[](https://pypi.org/project/z4j-arq/)
[](https://github.com/z4jdev/z4j-arq/blob/main/LICENSE)
The arq engine adapter for [z4j](https://z4j.com).
Streams every arq job lifecycle event from your async workers to the
z4j and accepts operator control actions from the dashboard.
Pair with z4j-arqcron to surface arq cron jobs.
## Compatibility
- arq 0.26+ and <1 (capped below the eventual arq 1.0 breaking-major)
- Python 3.10+
Full per-adapter matrix at .
## What it ships
| Capability | Notes |
|---|---|
| Job lifecycle events | enqueued, in-progress, complete, failed, retried |
| Job discovery | runtime function-list merge + static scan |
| Submit / retry / cancel | direct against the arq Redis pool |
| Bulk retry | filter-driven; re-enqueues matching jobs |
| Purge queue | with confirm-token guard |
| Reconcile task | via arq's Redis-backed result store |
Async-native, uses arq's existing on_job_start / on_job_end hooks.
## Install
```bash
pip install z4j-arq z4j-arqcron
```
Pair with a framework adapter (FastAPI is the most common pairing for
arq):
```bash
pip install z4j-fastapi z4j-arq z4j-arqcron
pip install z4j-bare z4j-arq z4j-arqcron # framework-free worker
```
## Pairs with
- [`z4j-arqcron`](https://github.com/z4jdev/z4j-arqcron), schedule adapter for arq cron jobs
## Reliability
- No exception from the adapter ever propagates back into arq's worker
loop or your job code.
- Events buffer locally when z4j is unreachable; workers never
block on network I/O.
## Documentation
Full docs at [z4j.dev/engines/arq/](https://z4j.dev/engines/arq/).
## License
Apache-2.0, see [LICENSE](LICENSE).
## Links
- Homepage: https://z4j.com
- Documentation: https://z4j.dev
- PyPI: https://pypi.org/project/z4j-arq/
- Issues: https://github.com/z4jdev/z4j-arq/issues
- Changelog: [CHANGELOG.md](CHANGELOG.md)
- Security: security@z4j.com (see [SECURITY.md](SECURITY.md))