taskforcesh /bullmq
BullMQ - Message Queue and Batch processing for NodeJS, Python, .NET, Elixir, Rust and PHP based on Redis or PostgreSQL
★ 9,601⑂ 759👁 35⑃ 3,142● 1,545▤ 1,046
+4
日增长
9,601
stars
759
forks
35
watchers
3,142
prs
1,545
issues
1,046
releases
README
The fastest, most reliable, Redis-based distributed queue for Node.js, Python, Elixir, .NET, Rust, PHP, and more.
Carefully written for rock solid stability and atomicity.
Read the documentation
Follow Us for important Bull/BullMQ/BullMQ-Pro news and updates!
🛠 Tutorials
You can find tutorials and news in this blog: https://blog.taskforce.sh/
News 🚀
🌐 Language agnostic BullMQ
BullMQ is available natively in multiple languages:
- Node.js / Bun — This repository (npm install bullmq)
- Python — python/ directory (pip install bullmq)
- Rust — rust/ directory (cargo add bullmq-official --rename bullmq)
- Elixir — elixir/ directory ({:bullmq, "~ x.x"})
- .Net — dotnet/ directory (dotnet add package BullMQ)
- PHP — php/ directory
For other platforms, check out the BullMQ Proxy.
Official FrontEnd
Supercharge your queues with a professional front end:
- Get a complete overview of all your queues.
- Inspect jobs, search, retry, or promote delayed jobs.
- Metrics and statistics.
- and many more features.
Sign up at Taskforce.sh
🚀 Sponsors 🚀
Dragonfly is a new Redis™ drop-in replacement that is fully compatible with BullMQ and brings some important advantages over Redis™ such as massive
better performance by utilizing all CPU cores available and faster and more memory efficient data structures. Read more here on how to use it with BullMQ.
Used by
Some notable organizations using BullMQ:
The gist
Install:
$ yarn add bullmq
If you use the node-redis adapter (createNodeRedisClient), install redis v5 or newer (redis = 5.0.0).
If you use the Valkey Glide adapter (createValkeyGlideClient), install @valkey/valkey-glide.
Add jobs to the queue:
ts
import { Queue } from 'bullmq';
const queue = new Queue('Paint');
queue.add('cars', { color: 'blue' });
Process the jobs in your workers:
ts
import { Worker } from 'bullmq';
const worker = new Worker('Paint', async job = {
if (job.name === 'cars') {
await paintCar(job.data.color);
}
});
Listen to jobs for completion:
ts
import { QueueEvents } from 'bullmq';
const queueEvents = new QueueEvents('Paint');
queueEvents.on('completed', ({ jobId }) = {
console.log('done painting');
});
queueEvents.on(
'failed',
({ jobId, failedReason }: { jobId: string; failedReason: string }) = {
console.error('error painting', failedReason);
},
);
Adds jobs with parent-child relationship:
ts
import { FlowProducer } from Top issues
#1670addBulk performance issues44 comments · 2023-02-09#3056After update to bullmq: Error: could not renew lock for job27 comments · 2025-02-05#632Stop/Abort a running job27 comments · 2021-07-06#2490Migrate to official node-redis24 comments · 2024-03-26#1021Parent job does not execute when sharing dependency with another job24 comments · 2022-01-25#2734[Bug]: BullMq jobs taking too much space in redis18 comments · 2024-08-26#2619[Bug]: Is it normal to get lots of "Command timed out" from bzpopmin?18 comments · 2024-06-23#3516[Bug]: Scheduled jobs queue randomly stop running all job schedulers16 comments · 2025-10-24
Discussions
#5039create-bullmq-app and eslint-plugin-bullmq: a scaffold and lint rules built on the Going to production guide0 comments · 2026-10-29#5006Go port of BullMQ — would you consider taking it in-tree?0 comments · 2026-10-24#4957CurlShot: per-account render concurrency for a screenshot API with BullMQ1 comments · 2026-10-17#4538Making a BullMQ processor safe to run twice0 comments · 2026-08-09#4247Bulltui0 comments · 2026-07-05#3975Should prometheus metrics really use a gauge type and not a counter?1 comments · 2026-04-09#3888ORCH — AI agent task queue with priority, state machine, and scope locking (like BullMQ for AI agents)0 comments · 2026-03-17#3790[Python] Timeline for production ready python library?1 comments · 2026-02-12
Latest release
vnet1.3.1 vnet1.3.1 2026-11-121.3.1 (2026-11-12) Bug Fixes flow: remove deduplication key that is associated with parent job that is removed (python) (elixir) (php) (rust) (dotnet) (5078) (2353552)