django-vtasks 2.1.0

A very fast valkey/postgres django tasks backend.

django-vtasks

Valkey Tasks. Very Fast Tasks.

From the team at GlitchTip, django-vtasks is a lightweight, async-first task queue for Django 6.0+.

Status: Newly feature complete. Beta quality. Use and report bugs.

Why django-vtasks?

• Async-first - Native asyncio worker for high-performance I/O
• Flexible backends - Start with Postgres, scale to Valkey without rewriting code
• Lightweight - Minimal dependencies, modern codebase
• Embedded mode - Run tasks in your ASGI server or as standalone workers

Features

• Dual backends: Database (Postgres/SQLite/MySQL) and Valkey (Redis-compatible)
• Scheduled tasks with cron syntax
• Unique tasks (Mutex and Throttle patterns)
• Batch processing for high-throughput queues
• Prometheus metrics
• Django admin interface for task management

Requirements

• Python 3.12+
• Django 6.0+
• Valkey 7+ (or Redis 7+) for Valkey backend

Quick Start

pip install django-vtasks

# For Valkey backend support:
pip install "django-vtasks[valkey]"

# settings.py
INSTALLED_APPS = ["django_vtasks", "django_vtasks.db"]

TASKS = {
    "default": {
        "BACKEND": "django_vtasks.backends.db.DatabaseTaskBackend",
    }
}

# myapp/tasks.py
from django_vtasks import task

@task
def send_email(user_id):
    # Your task logic
    pass

# In your views
send_email.enqueue(user_id)
# or async
await send_email.aenqueue(user_id)

# Run the worker
python manage.py runworker

Performance

Benchmarks show django-vtasks outperforms Celery in both enqueue and processing throughput:

• 1.9x faster enqueue (~1,200 ops/s vs ~650 ops/s)
• 1.5x faster processing (~250 ops/s vs ~166 ops/s)

See Benchmarks for full methodology and results.

Documentation

Full documentation is available at django-vtasks.glitchtip.com

• Getting Started
• Guide - Unique tasks, batching, scheduling, and more
• Configuration - All settings reference
• Deployment - Standalone workers, embedded mode, Kubernetes
• Benchmarks - Performance comparison with Celery

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

---

Built by the GlitchTip team.