Skip to content
Python multithreaded job distribution module.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
samples pep8 formatting cleanup Jun 2, 2011
CHANGES PyPI decided to not let me upload 0.9.3, great. Jul 27, 2015
LICENSE Fixed license information, cleaned up empty jobs dir. Feb 24, 2008 add and code clean-up scripts Jun 2, 2011 add and code clean-up scripts Jun 2, 2011 PyPI decided to not let me upload 0.9.3, great. Jul 27, 2015


Performing tasks in many threads made fun!

The workerpool module is a simple framework for easily distributing jobs into multiple worker threads.

Examples of usage can be found in the unit tests (/test) and the samples provided (/samples).

This module facilitates distributing simple operations into jobs that are sent to worker threads, maintained by a pool object.

It consists of these components:

  • Jobs - single units of work that need to be performed.
  • Workers - workers grab jobs from a queue and run them.
  • Worker pool - keeps track of workers and the job queue.

Getting Started

The best place to start for now is to read the code and look at the examples in the unit tests (/test) and the sample uses (/samples). Documentation contributions are welcome! What have you accomplished with the workerpool?


MassDownloader - How to write a simple multi-threaded mass downloader in under 10 lines of code.


There's good work being done on a native Python multiprocessing module. The functionality has a lot of overlap with workerpool. Worth having a look at!


  • 2011-06-02: Migrating project to Github.
  • 2008-03-09: Released workerpool 0.9.2 (CHANGES) Warning: WorkerPool constructor signature changed.
  • 2008-03-02: Released workerpool 0.9.1 (CHANGES)
  • 2008-03-02: Added MassDownloader tutorial.
  • TODO

Add more complete usage examples and wiki tutorials. More thorough unit testing Finalize the API for a 1.0 release

Who's Using WorkerPool?

  • s3funnel - Multithreaded tool for performing operations on Amazon's S3
  • starcluster - Tool for creating clusters of virtual machines on EC2

Are you using it? Let us know!


This module was originally developed during my work at Idée Inc. Big thanks to Idée for letting me open source it!


Copyright (c) 2008 Andrey Petrov (

Original copyright by Idee Inc. (

You can’t perform that action at this time.