CeleryViz

A UI-centric tool for visualising Celery task execution.

Debugging async Celery tasks usually means combing through log files. CeleryViz gives you a real-time visual trace of your task execution flow instead, so you can spot bottlenecks, failures, and task chains at a glance.

👉 Try the Live Demo

▶ Watch on YouTube

📖 Read the Docs

Quick Start

Using Python library

pip install celeryviz
celery -A your_app celeryviz

Or using Docker image (with your existing Celery app)

docker pull bhavyatech/celeryviz:latest
docker run -p 9095:9095 -v $PWD:/app bhavyatech/celeryviz:latest celery -A your_app celeryviz

Or using Docker image (with broker URL)

docker pull bhavyatech/celeryviz:latest
docker run -p 9095:9095 bhavyatech/celeryviz:latest celery --broker='<broker_url>' celeryviz

Then open http://localhost:9095/app/ in your browser.

📖 Full installation & setup guide →

What it does

• Visualises task flow: See tasks, their states, and execution order in a clean UI
• Real-time updates: Watch tasks progress live as your workers process them
• Zero code changes: Plug in via CLI, works with your existing Celery app
• Flexible deployment: Run as a Python package or a Docker container

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.
For issues or feature requests, open a GitHub Issue.

License

Apache 2.0

Reporting violations

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at bhavyapeshavaria@gmail.com. All complaints will be reviewed and investigated promptly and fairly.