WakaQ

Spec sheet

Purpose

WakaQ is a background task queue for Python backed by Redis, described as a minimal Celery alternative.Read 10 Oct 2026 · github.com

Deployment

The README provides an example systemd service configuration for running a WakaQ worker as a daemon.Read 9 Oct 2026 · github.com

License

The repository identifies its license as BSD-3-Clause.Read 10 Oct 2026 · github.com

Headquarters

San FranciscoRead 28 Sep 2026 · github.com

Founded

2013Read 28 Sep 2026 · github.com

Development and testing

The README describes mocking WakaQ to run tasks synchronously in development or tests without Redis or worker processes.Read 10 Oct 2026 · github.com

Feature scope

The maintainers say feature pull requests are not accepted and cite rate limiting and task deduplication as examples of features they do not intend to add.Read 10 Oct 2026 · github.com

Installation

The README gives `pip install wakaq` as the installation command.Read 9 Oct 2026 · github.com

Installation and deployment

The README shows installation with pip and an example of running a worker as a systemd daemon.Read 10 Oct 2026 · github.com

Language integration

WakaQ and its TypeScript counterpart share a Redis queue protocol, allowing Python and Node services to enqueue and run each other’s tasks.Read 9 Oct 2026 · github.com

Language interoperability

WakaQ and WakaQ-TS use the same Redis queue protocol, allowing Python and TypeScript services to enqueue or run tasks across languages.Read 10 Oct 2026 · github.com

Limitations

The README says feature pull requests are not accepted and names rate limiting and task deduplication as features it does not provide.Read 9 Oct 2026 · github.com

Local development

The README recommends mocking WakaQ to run tasks synchronously in development and tests without Redis or worker processes.Read 9 Oct 2026 · github.com

Production use

The README says WakaQ has been used in production at WakaTime since 2022.Read 10 Oct 2026 · github.com

Queue features

The project lists queue priorities, task broadcasting, soft and hard timeouts, and optional retries after soft timeouts.Read 10 Oct 2026 · github.com

Task execution

Tasks can be asynchronous or synchronous Python functions.Read 9 Oct 2026 · github.com

Tasks

Tasks can be synchronous or asynchronous, delayed until a specified time, or scheduled periodically.Read 10 Oct 2026 · github.com

Timeouts and retries

Tasks can have soft and hard timeout limits, with optional retries after soft timeouts.Read 9 Oct 2026 · github.com

Worker memory

Workers can be reloaded based on machine memory usage or the number of tasks processed.Read 10 Oct 2026 · github.com

Worker memory controls

Worker processes can be restarted based on memory use or the number of tasks processed.Read 9 Oct 2026 · github.com

Where Specifiction places it

• Task Queue Software#37 of 376.5