Metadata-Version: 2.4
Name: celeryviz
Version: 0.0.7
Summary: A UI centric tool for visualising Celery task execution.
Author: Bhavya Peshavaria
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Topic :: System :: Monitoring
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp==3.13.2
Requires-Dist: aiofiles==25.1.0
Requires-Dist: amqp==5.2.0
Requires-Dist: annotated-types==0.7.0
Requires-Dist: anyio==4.11.0
Requires-Dist: async-timeout==4.0.3
Requires-Dist: attrs==23.2.0
Requires-Dist: bidict==0.23.1
Requires-Dist: billiard==4.2.0
Requires-Dist: celery==5.4.0
Requires-Dist: certifi==2024.2.2
Requires-Dist: charset-normalizer==3.3.2
Requires-Dist: click==8.1.7
Requires-Dist: click-didyoumean==0.3.1
Requires-Dist: click-plugins==1.1.1
Requires-Dist: click-repl==0.3.0
Requires-Dist: fastapi==0.116.1
Requires-Dist: frozenlist==1.4.1
Requires-Dist: h11>=0.14.0
Requires-Dist: idna==3.7
Requires-Dist: kombu==5.3.7
Requires-Dist: multidict==6.0.5
Requires-Dist: packaging==24.0
Requires-Dist: prompt-toolkit==3.0.43
Requires-Dist: pydantic==2.12.0
Requires-Dist: pydantic_core==2.41.1
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: python-engineio==4.9.1
Requires-Dist: python-socketio==5.11.2
Requires-Dist: simple-websocket==1.0.0
Requires-Dist: six==1.16.0
Requires-Dist: sniffio==1.3.1
Requires-Dist: starlette==0.47.3
Requires-Dist: typing-inspection==0.4.2
Requires-Dist: typing_extensions==4.15.0
Requires-Dist: tzdata==2024.1
Requires-Dist: urllib3==2.2.1
Requires-Dist: uvicorn==0.37.0
Requires-Dist: vine==5.1.0
Requires-Dist: wcwidth==0.2.13
Requires-Dist: websocket-client==1.8.0
Requires-Dist: wsproto==1.2.0
Provides-Extra: dev
Requires-Dist: pytest==8.2.1; extra == "dev"
Requires-Dist: iniconfig==2.0.0; extra == "dev"
Requires-Dist: pluggy==1.5.0; extra == "dev"
Requires-Dist: exceptiongroup==1.2.1; extra == "dev"
Requires-Dist: tomli==2.0.1; extra == "dev"
Requires-Dist: requests==2.32.2; extra == "dev"
Requires-Dist: redis==5.0.4; extra == "dev"
Requires-Dist: httpx==0.27.0; extra == "dev"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

# CeleryViz

> A UI-centric tool for visualising Celery task execution.

[![PyPI](https://img.shields.io/pypi/v/celeryviz?logo=pypi&logoColor=white)](https://pypi.org/project/celeryviz/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue?logo=apache&logoColor=white)](LICENSE)
[![Docs](https://img.shields.io/readthedocs/celeryviz?logo=readthedocs&logoColor=white)](https://celeryviz.readthedocs.io/)
[![Docker Image](https://img.shields.io/badge/docker-bhavyatech%2Fceleryviz-blue?logo=docker)](https://hub.docker.com/r/bhavyatech/celeryviz)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/bhavya-tech/celeryviz)



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](https://bhavya-tech.github.io/celeryviz_demo/)**

▶ **[Watch on YouTube](https://www.youtube.com/watch?v=ZXM--jIFfR8)**

📖 **[Read the Docs](https://celeryviz.readthedocs.io/)**

## Quick Start

Using Python library

```bash
pip install celeryviz
celery -A your_app celeryviz
```

Or using Docker image (with your existing Celery app)

```bash
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)

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



Then open [http://localhost:9095/app/](http://localhost:9095/app/) in your browser.

📖 **[Full installation & setup guide →](https://celeryviz.readthedocs.io/en/latest/installation.html)**


## 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](CONTRIBUTING.md) before submitting a PR.  
For issues or feature requests, open a [GitHub Issue](https://github.com/bhavya-tech/celeryviz/issues).


## License

[Apache 2.0](LICENSE)


# Reporting violations

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