litestar-saq

What problem does it solve?

Litestar applications lack a first-party, integrated solution for managing background job queues, scheduled tasks, and worker processes, requiring developers to manually configure separate queue infrastructure and handle lifecycle management.

Core Features & Use Cases

• Integrated SAQ Plugin: Provides out-of-the-box SAQPlugin for Litestar that handles queue registration, worker lifespan management, and dependency injection for TaskQueues.
• Flexible Broker Support: Works with Redis for high-throughput workloads and web UI dashboards, or PostgreSQL for durable, SQL-queryable job history and PG-only deployments.
• Advanced Workflow Patterns: Includes a sidecar worker pattern for same-transaction outbox semantics, execution target routing (local/cloudrun/immediate), and real-time job progress updates via Litestar Channels.
• Use Case Example: A SaaS app uses this skill to enqueue email notification tasks, run nightly database cleanup cron jobs, and track long-running report generation progress in real-time for end users.

Quick Start

Use the litestar-saq skill to configure a Redis-backed background job queue with a scheduled cleanup task and a route handler that enqueues email notification jobs.