# celerator

> TUI application for debugging and monitoring Celery tasks in real-time with retry capabilities and detailed tracebacks

Stars: 27 · Categories: Dev Tools

- Repository: https://github.com/f4rih/celerator
- Page: https://www.trmn.sh/tools/celerator

## Install

- pip: `pip install celerator`

## Overview

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

```bash
# via pip
pip install celerator
```

![Celerator Demo](https://media.trmn.sh/cached/b00426f82a07d22c991a348f7ef5cbe53df0f87f616694d42180411a338a176c.png)

## Alternatives

- [peplum](https://www.trmn.sh/tools/peplum.md): Terminal-based browser and search interface for Python Enhancement Proposals (PEPs) (Python, 27 stars)
- [envdiff](https://www.trmn.sh/tools/envdiff.md): Snapshots a machine's system info, runtimes, env vars and network config to JSON, diffs snapshots, and validates environments against a YAML file. (Go, 25 stars)
- [az-tui](https://www.trmn.sh/tools/az-tui.md): Terminal UI for managing Azure Container Apps with browsing, logging, and container shell access (20 stars)
- [arduino-cli-interactive](https://www.trmn.sh/tools/arduino-cli-interactive.md): Interactive TUI wrapper for arduino-cli providing menu-driven Arduino development workflows (Shell, 44 stars)
- [lazycelery](https://www.trmn.sh/tools/lazycelery.md): Terminal UI for monitoring and managing Celery workers, queues, and tasks with real-time updates and keyboard navigation. (Rust, 56 stars)

---

Canonical: https://www.trmn.sh/tools/celerator