# graphile-worker

> Job queue for PostgreSQL

Latest version **0.18.0** (published 2026-09-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install graphile-worker
pnpm add graphile-worker
yarn add graphile-worker
bun add graphile-worker
```

Provides the command `graphile-worker`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.18.0 |
| Published | 2026-09-08 |
| First published | 2019-03-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.18.0 |
| Dependencies | 8 |
| Unpacked size | 639.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2405 |
| Author | Benjie Gillam |
| Maintainers | benjie |
| Keywords | postgresql, postgres, pg, worker, sql, easy, fast, jobs, background, tasks |

## Links

- npm: https://www.npmjs.com/package/graphile-worker
- Repository: https://github.com/graphile/worker
- Homepage: https://github.com/graphile/worker#readme
- Issues: https://github.com/graphile/worker/issues
- npm.io page: https://npm.io/package/graphile-worker

## Dependencies (8)

- [pg](https://npm.io/package/pg.md) ^8.11.3
- [json5](https://npm.io/package/json5.md) ^2.2.3
- [yargs](https://npm.io/package/yargs.md) ^17.7.2
- [@types/pg](https://npm.io/package/@types/pg.md) ^8.10.5
- [cosmiconfig](https://npm.io/package/cosmiconfig.md) ^8.3.6
- [@types/debug](https://npm.io/package/@types/debug.md) ^4.1.10
- [graphile-config](https://npm.io/package/graphile-config.md) ^0.0.1-beta.16
- [@graphile/logger](https://npm.io/package/@graphile/logger.md) ^0.3.0

## Alternatives

- [cron](https://npm.io/package/cron.md) — 4.9M weekly downloads
- [@vercel/queue](https://npm.io/package/@vercel/queue.md) — 731.6K weekly downloads
- [create-sonicjs](https://npm.io/package/create-sonicjs.md) — 1.6K weekly downloads
- [@exellix/jobs-api](https://npm.io/package/@exellix/jobs-api.md) — 941 weekly downloads
- [@forwardimpact/libskill](https://npm.io/package/@forwardimpact/libskill.md) — 575 weekly downloads

## Recent versions

- 0.18.0 (latest) — 2026-09-08
- 0.17.0-rc.0 (rc) — 2025-07-29
- 0.15.2-bridge.0 (bridge15) — 2023-11-20
- 0.13.1-bridge.0 (bridge13) — 2023-11-20
- 0.17.3 — 2026-07-08
- 0.17.2 — 2026-06-12
- 0.17.1 — 2026-06-12
- 0.17.0 — 2026-06-12
- 0.17.0-canary.1fcb2a0 — 2024-12-11
- 0.17.0-canary.0e88c16 — 2024-12-11
- 0.17.0-canary.f6a6889 — 2024-12-11
- 0.17.0-canary.9817f67 — 2024-11-15
- 0.17.0-canary.6aeb577 — 2024-11-15
- 0.17.0-canary.379fb2e — 2024-11-13
- 0.17.0-canary.67dbcb6 — 2024-10-16
- … 50 more at https://npm.io/package/graphile-worker/versions

## README

<img width="120" height="120" title="Graphile Worker logo" src="https://cdn.rawgit.com/graphile/worker/2c8091e0bcce5d39e46a1b3833daf20b59097d1e/website/static/img/logo.optimized.svg" />

# graphile-worker

[![Patreon sponsor button](https://img.shields.io/badge/sponsor-via%20Patreon-orange.svg)](https://patreon.com/benjie)
[![Discord chat room](https://img.shields.io/discord/489127045289476126.svg)](http://discord.gg/graphile)
[![Package on npm](https://img.shields.io/npm/v/graphile-worker.svg?style=flat)](https://www.npmjs.com/package/graphile-worker)
[![MIT license](https://img.shields.io/npm/l/graphile-worker.svg)](LICENSE.md)
[![Follow](https://img.shields.io/badge/twitter-@GraphileHQ-blue.svg)](https://twitter.com/GraphileHQ)

Job queue for PostgreSQL running on Node.js - allows you to run jobs (e.g.
sending emails, performing calculations, generating PDFs, etc) "in the
background" so that your HTTP response/application code is not held up. Can be
used with any PostgreSQL-backed application. Pairs beautifully with
[PostGraphile](https://www.graphile.org/postgraphile/) or
[PostgREST](http://postgrest.org/).

## [Website at worker.graphile.org](https://worker.graphile.org)

<!-- SPONSORS_BEGIN -->

## Crowd-funded open-source software

To help us develop this software sustainably, we ask all individuals and
businesses that use it to help support its ongoing maintenance and development
via sponsorship.

### [Click here to find out more about sponsors and sponsorship.](https://www.graphile.org/sponsor/)

And please give some love to our featured sponsors 🤩:

<table><tr>
<td align="center"><a href="https://gosteelhead.com/"><img src="https://graphile.org/images/sponsors/steelhead.svg" width="90" height="90" alt="Steelhead" /><br />Steelhead</a> *</td>
</tr></table>

<em>\* Sponsors the entire Graphile suite</em>

<!-- SPONSORS_END -->

---
_Source: https://npm.io/package/graphile-worker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._