This release is a pre-release and may not be stable for production use.
django-celeryx
Celery monitoring and management for Django admin. Like Flower, but embedded in your Django admin with htmx for real-time updates.
Installation
pip install django-celeryx[celery]
Or with celery-asyncio:
pip install django-celeryx[celery-asyncio]
Quick Start
INSTALLED_APPS = [
# ...
"django_celeryx.admin",
]
That's it. Start your Django server and navigate to the admin to see your Celery tasks and workers.
Features
- Real-time task monitoring - Live task list with state, args, result, timing, auto-refreshing via htmx
- Worker management - View worker status, pool info, active queues, configuration
- Control actions - Revoke/terminate tasks, shutdown/restart workers, manage pools and queues
- Broker overview - Queue names, routing keys, consumer counts
- Django admin native - Looks and feels like standard Django admin, no separate service to run
- Database persistence - All state persisted to database (dedicated SQLite file by default, or any Django database)
- Registered tasks - Browse all registered task types, link to filtered task list
Task Monitoring
The task list shows all Celery tasks with color-coded states:
- PENDING (grey), RECEIVED (yellow), STARTED (blue), SUCCESS (green), FAILURE (red), RETRY (orange), REVOKED (purple)
Configurable columns via TASK_COLUMNS setting.
Worker Management
Worker detail view with tabbed interface (matching Flower):
- Pool: pool type, concurrency, processes. Controls: grow/shrink, autoscale
- Queues: active queues. Controls: add/cancel consumer
- Tasks: processed counts, active/scheduled/reserved/revoked tasks
- Limits: rate limits and timeouts
- Config: full worker Celery configuration
- Stats: system resource usage, broker connection info
Control Actions
Full control parity with Flower:
- Revoke / terminate / abort tasks
- Shutdown / restart worker pool
- Grow / shrink pool, set autoscale
- Add / cancel queue consumer
- Set rate limits and time limits
Configuration
CELERYX = {
"MAX_TASK_COUNT": 100_000,
"MAX_TASK_AGE": 86400, # 24 hours
"AUTO_MIGRATE": True, # migrate the auto-configured SQLite file on startup
"AUTO_REFRESH_INTERVAL": 3,
"TASK_COLUMNS": ["name", "uuid", "state", "worker", "received", "started", "runtime"],
}
See the configuration guide for every setting, the permission model, and the security notes.
Unfold Theme
For django-unfold users:
INSTALLED_APPS = [
"unfold",
# ...
"django_celeryx.unfold", # instead of django_celeryx.admin
]
Documentation
Full documentation at oliverhaas.github.io/django-celeryx
Requirements
- Python 3.12+
- Django 5.2+
- Celery 5.4+ or celery-asyncio 6.0+
License
MIT
Metadata
Release files for django-celeryx 0.1.0a3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| django_celeryx-0.1.0a3.tar.gz | 43.6 kB | With provenance | Details for django_celeryx-0.1.0a3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| django_celeryx-0.1.0a3-py3-none-any.whl | Python 3 | none | any | Details for django_celeryx-0.1.0a3-py3-none-any.whl |
Total release size: 104.0 kB
Release files / django_celeryx-0.1.0a3.tar.gz
| Download URL | django_celeryx-0.1.0a3.tar.gz |
|---|---|
| Size | 43.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2e9181428e4c8b69c4435ef1e7768e0055214c9618ccf2b4eb77486d41fa744a
|
|
BLAKE2b-256 checksum How to use checksums |
d28f5671c556e7cf8e6bc1a586c97485a44dc034b8aad40ba0b7b976a50b26fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 21, 2026.
Transparency logRelease files / django_celeryx-0.1.0a3-py3-none-any.whl
| Download URL | django_celeryx-0.1.0a3-py3-none-any.whl |
|---|---|
| Size | 60.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8814152bad3d0d62a30df78f9d228ab0b429d7befffc495424dec59a504afcd
|
|
BLAKE2b-256 checksum How to use checksums |
e253c51d2cee9074e6b5d15931d3bdd4e46b5f70fdc80bf31808ea3701d4f3d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 21, 2026.
Transparency logSecurity for django-celeryx 0.1.0a3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for django_celeryx-0.1.0a3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.