vercel-workers

What it is and what it does

vercel-workers is a Python SDK that bridges your application to Vercel's queue and worker service infrastructure. It provides primitives for publishing messages to Vercel Queues and subscribing to them via decorators, plus drop-in adapters for existing task systems like Celery, Dramatiq, and Django. The package depends on httpx, anyio, pydantic, python-dotenv, and the vercel client library.

Typical usage involves defining a producer (e.g., a FastAPI endpoint) that publishes messages, and a worker service that consumes them. The SDK handles authentication via VERCEL_QUEUE_TOKEN and can be deployed as a Vercel Worker Service alongside your main application. It supports both direct message handling and integration with established task queue frameworks.

Use it for:

• Publish background tasks from a FastAPI or web service to Vercel Queues for asynchronous processing.
• Migrate existing Celery or Dramatiq task systems to Vercel infrastructure with minimal code changes.
• Implement Django task callbacks routed through Vercel's queue infrastructure.
• Build event-driven microservices that consume messages from Vercel Queues in dedicated worker services.
• Decouple request handling from long-running operations using the @subscribe decorator pattern.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python SDK for publishing and consuming messages on Vercel Queues, with built-in adapters for Celery, Dramatiq, and Django task systems.

Yes, if you are building on Vercel and need a lightweight queue integration. The low install friction, recent maintenance, MIT license, and native support for popular task frameworks make it a practical choice. No, if you are not using Vercel or require a self-hosted queue solution—this SDK is tightly coupled to Vercel's infrastructure.

Install

vercel-workers on PyPI

pip install vercel-workers

uv add vercel-workers

poetry add vercel-workers

Installing vercel-workers

Before you install

Low install friction with a pure Python wheel distribution. Marked as active with a recent release cycle (55 days since last update). Requires Python 3.12 or later.

License in practice

MIT license permits commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install vercel-workers

from vercel_workers import subscribe

@subscribe(topic="default")
def handle_message(body: dict):
    print(body)

Requires Python 3.12 or later. Running outside Vercel requires VERCEL_QUEUE_TOKEN environment variable.

Verify before relying

• Whether the package is actively maintained by Vercel or community-driven (repo metadata unavailable).
• Performance characteristics and throughput limits for queue operations.
• Whether optional adapter extras (celery, dramatiq, django) are automatically installed or must be specified.

Package facts

Evidence: vercel_workers-0.0.25-py3-none-any.whl

Tags

More Distributed Computing packages