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).

Release files for vercel-workers 0.0.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vercel-workers 0.0.25
File	Size	Uploaded
vercel_workers-0.0.25.tar.gz	64.1 kB	Jun 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for vercel-workers 0.0.25
File	Interpreter	ABI	Platform	Reset
vercel_workers-0.0.25-py3-none-any.whl 61.7 kB Jun 20, 2026	Python 3	none	any	Details

Total release size: 125.8 kB

Release files / vercel_workers-0.0.25.tar.gz

Download URL	vercel_workers-0.0.25.tar.gz
Size	64.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`212ded01400b524be51d251df49f801caf115ad7d48cca7eb168cbeceda3def3`
BLAKE2b-256 checksum How to use checksums	`30df04d37021ad7ca53b7599c313e411d91623c7a005c741f491d1eefb7a9f0c`
Upload date	Jun 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / vercel_workers-0.0.25-py3-none-any.whl

Download URL	vercel_workers-0.0.25-py3-none-any.whl
Size	61.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6901228a90e83e292e6a176161e66e6a7c43d9f4fd9e13d6bd87092ad09ffd8b`
BLAKE2b-256 checksum How to use checksums	`855a2ae6debc94fcfd7ce06b0e4ac5505be29ca04e76d6c99af35d4372dd7eda`
Upload date	Jun 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`