django-vtasks 2.1.2

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 simulate async Django views dispatching tasks — the real ASGI use case.

Scenario (Sleep 10ms)	Enqueue (ops/s)	Process (ops/s)	Peak RSS (MB)	Valkey Conns
VTasks	5,203	3,796	76	3
Celery Threads	2,228	894	123	11
RQ	436	25	170	4

VTasks: 4x faster processing, 2x faster enqueue, 38% less memory vs Celery.

See Benchmarks for full methodology, cloud latency results, and how to reproduce.

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.