celery-progress
Drop in, configurable, dependency-free progress bars for your Django/Celery applications.
Decision gist · record as of 2026-08-14
Yes, if you are building a Django application with Celery tasks and need a simple, zero-dependency progress bar for the frontend. The library is stable and well-suited for standard use cases. However, note that maintenance is dormant (last update 561 days ago); verify compatibility with your specific Django and Celery versions before relying on it for new projects, and be prepared to maintain a fork if breaking changes occur in future Django releases.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Django and Celery to be already set up in your project; WebSocket support requires Django Channels.
- Low friction installation with no runtime dependencies.
- Dormant maintenance status (last commit 2025-01-30, no updates in 561 days), but the package is stable and archived repository shows active development ceased rather than abandonment.
License · maintenance · safety
MIT License (permissive) — MIT License permits commercial and private use with minimal restrictions—you may use, modify, and distribute the package freely provided you retain the license notice.
last release 2025-01-30 (561 days) · last repo commit 2025-01-30 · 497 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 368,278 downloads/mo, #7,189 on PyPI
Alternatives
Verify before relying
pip install celery-progress
# In Django settings.py:
INSTALLED_APPS = [..., 'celery_progress']
# In urls.py:
path('celery-progress/', include('celery_progress.urls'))
# In task:
from celery_progress.backend import ProgressRecorder
@shared_task(bind=True)
def my_task(self):
progress_recorder = ProgressRecorder(self)
progress_recorder.set_progress(1, 10)
# In template:
<script src="{% static 'celery_progress/celery_progress.js' %}"></script>
<script>
CeleryProgressBar.initProgressBar("{% url 'celery_progress:task_status' task_id %}");
</script>- Whether the package works with Django versions beyond 5.1 or Python versions beyond 3.12.
- Current state of WebSocket support implementation and any known limitations.
- Whether dormant status indicates the package is sufficiently stable or if active maintenance is needed for new Django/Celery releases.
What it is and what it does
Celery Progress is a Django integration library that bridges Celery background tasks and the frontend by providing real-time progress bar updates. It works by recording task progress on the backend using a ProgressRecorder wrapper and polling (or streaming via WebSocket) task status to the frontend, where a JavaScript component renders a visual progress bar. The library is dependency-free at runtime, requiring only that you have Django and Celery already configured.
You add it to Django's INSTALLED_APPS, wire up its URL endpoints, wrap your Celery tasks with ProgressRecorder calls, and initialize the frontend JavaScript with a task ID. The library handles polling intervals, customizable colors, messages, result display, and experimental support for Celery groups. It is designed for straightforward setup with optional customization of progress bar appearance and behavior.
Use it for
- Display a real-time progress bar while a long-running Celery task (e.g., file export, data processing) executes in the background.
- Show task status updates and final results to users without page reloads, improving perceived responsiveness of async operations.
- Track progress of multiple related tasks using Celery groups with a single unified progress indicator.
- Customize progress bar colors, polling intervals, and callback handlers to match application UI and error-handling requirements.
- Stream live task updates via WebSocket using Django Channels for lower-latency progress notifications in real-time applications.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a Django application with Celery tasks and need a simple, zero-dependency progress bar for the frontend.
The library is stable and well-suited for standard use cases. However, note that maintenance is dormant (last update 561 days ago); verify compatibility with your specific Django and Celery versions before relying on it for new projects, and be prepared to maintain a fork if breaking changes occur in future Django releases.
Install
celery-progress on PyPI
Before you install
Low friction installation with no runtime dependencies. Dormant maintenance status (last commit 2025-01-30, no updates in 561 days), but the package is stable and archived repository shows active development ceased rather than abandonment.
Requires Django and Celery to be already set up in your project; WebSocket support requires Django Channels.
License in practice
MIT License permits commercial and private use with minimal restrictions—you may use, modify, and distribute the package freely provided you retain the license notice.
Quickstart
pip install celery-progress
# In Django settings.py:
INSTALLED_APPS = [..., 'celery_progress']
# In urls.py:
path('celery-progress/', include('celery_progress.urls'))
# In task:
from celery_progress.backend import ProgressRecorder
@shared_task(bind=True)
def my_task(self):
progress_recorder = ProgressRecorder(self)
progress_recorder.set_progress(1, 10)
# In template:
<script src="{% static 'celery_progress/celery_progress.js' %}"></script>
<script>
CeleryProgressBar.initProgressBar("{% url 'celery_progress:task_status' task_id %}");
</script>Verify before relying
- Whether the package works with Django versions beyond 5.1 or Python versions beyond 3.12.
- Current state of WebSocket support implementation and any known limitations.
- Whether dormant status indicates the package is sufficiently stable or if active maintenance is needed for new Django/Celery releases.
Package facts
| License | MIT License permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 561 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 368,278 / month, #7,189 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Environment :: Web EnvironmentFramework :: DjangoFramework :: Django :: 3.2Framework :: Django :: 4.0Framework :: Django :: 4.1Framework :: Django :: 4.2Framework :: Django :: 5.0Framework :: Django :: 5.1Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Internet :: WWW/HTTPTopic :: Internet :: WWW/HTTP :: Dynamic Content |
Evidence: celery_progress-0.5-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “django celery progress bar”
- celery-progressProvides drop-in progress bars for Django views that display…
- enlightenEnlighten is a console progress bar library that displays progress…
- progressbar33Displays text-based progress bars in the console, with customizable…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also progress · celery · progressbar2 · flower · django-celery-results · alive-progress · django-celery-email · aa-taskmonitor · wget · celery-batches