Skip to main content
Celery Root is a multi-worker monitoring, management, and visualization tool for Celery. It ships with a Django-based UI, a lightweight event listener/collector, and helper utilities for inspecting queues, tasks, workers, and beat schedules.
Celery Root logo

What you get

  • Task list with filtering, sorting, and full detail views.
  • Task relation graph visualization (chains, groups, chords, maps).
  • Worker fleet overview and per-worker drill-down.
  • Broker queue inspection and purge actions.
  • Beat schedule overview and editor.
  • Pluggable storage (SQLite by default).
  • Optional Prometheus and OpenTelemetry metrics exporters.
  • Optional MCP server for safe read-only data access.

Start here

Quickstart

Run the demo stack and open the UI.

Configure

Enable or disable components and set database paths.

UI tour

See where to manage tasks, workers, brokers, and beat.

CLI

Run Celery Root as a standalone service or a Celery subcommand.

Architecture at a glance

The supervisor process launches a DB manager, event listeners per broker, optional metrics exporters, the web UI, and the MCP server. See the architecture overview for details.

Architecture