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
TypeScriptMITCreated 2018-12-19bullmq.io
下载:vnet1.3.1vnet1.3.1 ↓1.3.12026-11-12
+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

Discussions

Latest release

vnet1.3.1 vnet1.3.1 2026-11-12
1.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)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON