Skip to main content

Task queue based on Django models.

Project description

ModelQueue is an Apache2 licensed task queue based on Django models.

For example, in appname/

import modelqueue
from django.db import models

class Task(models.Model):
    data = models.TextField()
    status = modelqueue.StatusField(
        # ^-- Index for faster queries.
        # ^-- Waiting state is ready to run.

And in appname/management/commands/

import modelqueue, time
from import BaseCommand
from .models import Task

class Command(BaseCommand):

    def handle(self, *args, **options):
        while True:
            task =
                # ^-- Queryset of models to process.
                # ^-- Field name for model queue.
                # ^-- Callable to process model.
            if task is None:
                # ^-- Bring your own parallelism/concurrency.

    def process(self, report):
        pass  # Process task models.

And in appname/

class TaskAdmin(admin.TaskAdmin):
    list_filter = [
        # ^-- Filter tasks in admin by queue state.

ModelQueue is a hazardous project. It takes a bad idea and makes it easy and effective. You may come to regret using your database as a task queue but it won’t be today!


“I didn’t design relational database systems for this.” ~ Edgar Codd

“Well, at least you’re using transactions.” ~ Jim Gray

“You have successfully ignored most of what’s important in queueing theory.” ~ Agner Erlang

Does your company or website use ModelQueue? Send us a message and let us know.


  • Pure-Python
  • Fully documented
  • Performance matters
  • 100% test coverage
  • Hours of stress testing
  • Developed on Python 3.6
  • Tested on Django 1.11
  • Tested on CPython 2.7, 3.4, 3.5, 3.6, PyPy and PyPy3
  • Tested on Linux, Mac OS X, and Windows
  • Tested using Travis CI and AppVeyor CI


Installing ModelQueue is simple with pip:

$ python -m pip install modelqueue

You can access documentation in the interpreter with Python’s built-in help function:

>>> import modelqueue
>>> help(modelqueue)

User Guide

For those wanting more details, this part of the documentation describes introduction, benchmarks, development, and API.

ModelQueue License

Copyright 2018 Grant Jenks

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
modelqueue-1.0.3-py2.py3-none-any.whl (9.7 kB) Copy SHA256 hash SHA256 Wheel py2.py3
modelqueue-1.0.3.tar.gz (7.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page