---
id: vercel-workers
version: "0.0.25"
license: MIT
license_treatment: permissive
maintenance: active
---

# vercel-workers — Python SDK for Vercel Workers

License: permissive · Maintenance: active · Downloads: 1.3M/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vercel queues python sdk, message queue vercel workers, celery dramatiq django adapter, vercel worker services, python task queue integration, vercel queue consumer producer, vercel-platform, task-queue, async-tasks

[View on SkillFed](https://skillfed.io/packages/vercel-workers) · [View on PyPI](https://pypi.org/project/vercel-workers/)