One-click install
npx skills add https://github.com/litestar-org/litestar-skills --skill litestar-queues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: litestar-queues
Source: https://github.com/litestar-org/litestar-skills/tree/main/plugins/litestar/skills/litestar-queues
Command: npx skills add https://github.com/litestar-org/litestar-skills --skill litestar-queues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the need to build custom, error-prone task queue infrastructure for Litestar applications, and avoids the friction of integrating third-party task runners like Celery, RQ, or Dramatiq that do not align with Litestar's native plugin system, dependency injection patterns, and application lifecycle.

Core Features & Use Cases

  • Native Litestar Integration: First-party queue abstraction that works seamlessly with Litestar's plugin system, DI, and lifespan events, with no external framework adapters required.
  • Flexible Backend & Execution Options: Choose from in-memory, SQLSpec, Advanced Alchemy, Redis, Valkey, or Google Cloud Run backends to match your existing persistence and execution stack.
  • Use Case: A SaaS platform that needs to run scheduled report generation, background data imports, and long-running billing jobs without blocking API responses, while tracking task progress for end users and operators.

Quick Start

Use the litestar-queues skill to configure a QueuePlugin with a SQLSpec backend for your Litestar app, define a scheduled report generation task, and set up a standalone worker service to process queued jobs.

Frequently Asked Questions about litestar-queues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run background tasks in a Litestar application without using Celery?

You can use a native Litestar queue abstraction to handle background tasks, eliminating the need for third-party task runners like Celery. It integrates directly with Litestar's plugin system and dependency injection for durable task state and scheduled job execution.

Does Litestar support scheduled jobs and worker management natively?

Yes, Litestar supports scheduled jobs and worker management natively through a first-party queue abstraction. It provides configurable worker placement, CLI-based worker management, and task progress events without relying on external frameworks.

What's the best way to configure task queuing with Redis in a Litestar app?

The best way to configure Redis task queuing in a Litestar app is using the native queue abstraction with a QueuePlugin. This provides seamless integration with Litestar's lifespan events and supports durable task state, retry handling, and configurable worker placement.

Can I use SQLSpec or Advanced Alchemy for durable task state in Litestar?

Yes, you can use SQLSpec or Advanced Alchemy as backend options for durable task state in Litestar. The native queue abstraction supports these persistence stacks alongside Redis, Valkey, in-memory, and Google Cloud Run backends for flexible execution.

Why should I avoid third-party task runners with Litestar applications?

You should avoid third-party task runners like Celery or RQ with Litestar because they do not align with Litestar's native plugin system, dependency injection patterns, and application lifecycle, creating integration friction and requiring custom adapters.

How do I set up a standalone worker to process queued jobs in Litestar?

You can set up a standalone worker to process queued jobs in Litestar using the CLI-based worker management provided by the native queue abstraction. This handles task registration, enqueueing, retry handling, and dependency resolution without external task runners.