celerator

Celerator is a terminal-based interface for monitoring and debugging Celery task queues. It connects to Celery brokers (Redis, RabbitMQ) and displays real-time task events through an interactive TUI built with the Textual framework. The tool captures task lifecycle events including execution status, failures, and completion data without requiring any code changes to existing applications.

The interface provides detailed debugging capabilities including viewing task arguments, keyword arguments, exceptions, and full tracebacks. Users can retry failed tasks with either their original arguments or custom parameters using keyboard shortcuts. All task data is stored in-memory during the session, allowing users to scroll through and inspect historical task executions.

The tool works with any Celery-based application including Django, Flask, and FastAPI projects. It requires Celery workers to be started with the --events flag to emit task event data. Navigation is entirely keyboard-driven with shortcuts for retrying tasks, clearing the task table, and viewing detailed task information.

Installation

# via pip
pip install celerator