vercel-workers

Python SDK for Vercel Queues and Vercel Worker Services.

It includes:

send() and @subscribe primitives for publishing and consuming queue messages
adapters for Celery, Dramatiq, and Django tasks

Install

pip install vercel-workers

Optional adapter extras:

pip install "vercel-workers[celery]"
pip install "vercel-workers[dramatiq]"
pip install "vercel-workers[django]"

Worker Service deployment shape

vercel.json

{
  "projectSettings": { "framework": "services" },
  "experimentalServices": {
    "web": {
      "framework": "fastapi",
      "entrypoint": "main.py",
      "routePrefix": "/"
    },
    "worker": {
      "type": "worker",
      "entrypoint": "worker.py",
      "topic": "default",
      "consumer": "default"
    }
  }
}

For worker services, worker.py should expose worker definitions (for example a @subscribe function, Celery app, or Dramatiq broker) and import task modules so handlers are registered.

Examples

examples/basic: FastAPI producer + @subscribe worker service
examples/celery: Celery + worker service
examples/dramatiq: Dramatiq adapter + worker service
examples/django: Django tasks backend + queue callback route at /api/queue/callback

When running outside Vercel, set VERCEL_QUEUE_TOKEN (and optionally VERCEL_QUEUE_BASE_URL).