qstash

library3.4.0pypypi✓ verified 85d ago

Python SDK for Upstash QStash, a message queue and workflow orchestration service for serverless applications. v3.4.0 removes deprecated LLMs support and adds new QStash features. Regular releases.

workflow aws

pip install qstash

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · QSTASH

qstash

workflowpythonv3.4.0

Install

2.2s avg

Import

—

Disk

21MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.4.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 22.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.2s · import 0.000s · 23MB

21MB installed

● package 21MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

QStash

✓ from qstash import QStash

✗ from qstash import QStashClient

AsyncQStash

✓ from qstash import AsyncQStash

Receiver

✓ from qstash import Receiver

Initialize client with your QStash token (from Upstash console) and publish a message.

import os from qstash import QStashClient client = QStashClient(token=os.environ.get('QSTASH_TOKEN', '')) response = client.publish(url="https://example.com/api", body="Hello, QStash!") print(response)

Debug

Known issues

breakingIn v3.0.0, the entire LLM chat completion support was removed. Any code using `client.llm.chat` or similar will break.

fix

Migrate to a separate LLM SDK (e.g., OpenAI) and remove usage of deprecated methods.

affects: <3.0.0

deprecatedThe `delay` and `not_before` parameters in `enqueue` are removed in v2.0.1+. Use `schedule` or manual delay instead.

fix

Remove these parameters; if you need delayed execution, use schedules or set a later `not_before` via the API's `schedule` method.

affects: <2.0.1

gotchaClient initialization can fail silently if the token is missing; always validate `QSTASH_TOKEN` is set.

fix

Check that the environment variable exists before creating the client: `assert os.environ.get('QSTASH_TOKEN'), 'Missing QStash token'`

affects: all

gotchaAsync client requires an event loop; using it in synchronous context will raise RuntimeError.

fix

Ensure you use `await` inside an async function or run with `asyncio.run()`. Example: `asyncio.run(main())`.

affects: all

Upgrade

Version history

3.4.0latest on PyPI · released Mar 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

28 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/upstash/qstash-py ↗

packagehttps://pypi.org/project/qstash/ ↗

homepagehttps://upstash.com ↗