Celerator is a TUI (Text User Interface) application for debugging and monitoring Celery tasks in real time. It connects to your Celery broker (Redis, RabbitMQ, etc.), listens to task lifecycle events, and presents them in an interactive terminal interface — complete with retry capabilities, traceback viewing, and more.
It uses Celery's built-in event system, meaning no code changes are required in your app — just run your workers with --events enabled.
The interface is built using Textual, a modern TUI framework for Python.
- Live event monitoring: Captures real-time task data using the Celery event stream
- Retry failed tasks: One-key retry of failed tasks with original or custom arguments
- Detailed debug panels: View args, kwargs, exceptions, and tracebacks
- Full keyboard support: Efficient, mouse-free task inspection
- In-memory task store: View and scroll through all received tasks
- Styled UI: Powered by Textual and customizable stylesheets
- Works with any Celery-based app, including Django, Flask, FastAPI, etc.
pip install celeratorTo use Celerator, you need to start your Celery worker with the --events flag enabled to emit task event data:
celery -A your_project worker --loglevel=info --eventsThen, in another terminal, launch Celerator with the same broker URI:
celerator --broker=redis://localhost:6379/0| Key | Action |
|---|---|
r |
Retry selected task |
ctrl+r |
Retry with custom args |
c |
Clear task table |
q |
Quit the app |
↑ / ↓ |
Navigate task list |
Enter |
Show traceback / task details |