Installation#

Install the core package. It provides task registration, the Litestar plugin, in-memory queue storage, and local or immediate execution:

pip install litestar-queues

Optional extras#

Install only the integration your application uses:

Command

Adds

pip install "litestar-queues[sqlspec]"

SQLSpec queue persistence; install the SQLSpec driver for your database separately.

pip install "litestar-queues[advanced-alchemy]"

Advanced Alchemy and SQLAlchemy queue persistence.

pip install "litestar-queues[redis]"

Redis queue persistence and worker wakeups.

pip install "litestar-queues[valkey]"

Valkey queue persistence and worker wakeups.

pip install "litestar-queues[cloudrun]"

Google Cloud Run Jobs execution.

pip install "litestar-queues[sqs]"

Amazon SQS execution dispatch and consumers.

pip install "litestar-queues[pubsub]"

Google Cloud Pub/Sub execution dispatch and streaming consumers.

pip install "litestar-queues[rabbitmq]"

RabbitMQ 4.3+ execution dispatch and consumers on Python 3.11+.

pip install "litestar-queues[otel]"

OpenTelemetry instrumentation.

pip install "litestar-queues[prometheus]"

Prometheus metrics.

An extra installs the libraries for an integration. It does not configure that integration or choose where tasks run. Complete the Quickstart, then see Choose backends.