{"id":26719924,"url":"https://github.com/haoke98/django-celery-stack","last_synced_at":"2026-05-18T03:11:20.407Z","repository":{"id":228595207,"uuid":"774424371","full_name":"Haoke98/django-celery-stack","owner":"Haoke98","description":"A merge of django-celery-beat, django-celery-result, django-celery-progress.","archived":false,"fork":false,"pushed_at":"2024-03-31T13:55:25.000Z","size":340,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-07T22:02:36.180Z","etag":null,"topics":["celery","django","django-celery","django-celery-beat","django-celery-progress","django-celery-result","task-distribution","task-scheduler"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Haoke98.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-19T14:26:38.000Z","updated_at":"2024-03-19T21:17:01.000Z","dependencies_parsed_at":"2025-03-27T18:43:00.566Z","dependency_job_id":null,"html_url":"https://github.com/Haoke98/django-celery-stack","commit_stats":null,"previous_names":["haoke98/django-celery-stack"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Haoke98/django-celery-stack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haoke98%2Fdjango-celery-stack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haoke98%2Fdjango-celery-stack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haoke98%2Fdjango-celery-stack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haoke98%2Fdjango-celery-stack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Haoke98","download_url":"https://codeload.github.com/Haoke98/django-celery-stack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Haoke98%2Fdjango-celery-stack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33163442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["celery","django","django-celery","django-celery-beat","django-celery-progress","django-celery-result","task-distribution","task-scheduler"],"created_at":"2025-03-27T18:30:09.177Z","updated_at":"2026-05-18T03:11:20.385Z","avatar_url":"https://github.com/Haoke98.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Django Celery Stack\n\nEnglish |  [中文](README.zh.md)\n\nA comprehensive stack solution that ensures seamless compatibility between Celery and Django, integrating key components\nsuch as django-celery-beat, django-celery-result, and django-celery-progress. This integration provides web developers\nwith a robust framework for handling asynchronous tasks, scheduling, and tracking task execution within their Django\nprojects.\n\nIn addition, its interface and interaction are very friendly and modern, and it has overcome the traditional interaction\nshortcomings of Django by referencing [DjangoAsyncAdmin](https://github.com/Haoke98/DjangoAsyncAdmin).\n\n![](assets/registeredTaskRunForm.png)\n\n### Django Celery Stack \u0026 Admin offers the following key features:\n\n* **Asynchronous Task Queue** :\n\n      Utilize Celery’s distributed message passing system to delegate CPU-bound tasks to the background, improving the responsiveness and performance of the application.\n\n* Scheduled Task Scheduler:\n\n      With the built-in Celery Beat scheduler, easily arrange periodic tasks such as data synchronization, report generation, etc.\n\n* Task Result Tracking:\n\n      Leverage Celery’s result backend to persist task execution results, making it easier to debug and monitor task status.\n\n* Progress Updates:\n\n      By integrating with django-celery-progress, provide real-time task progress updates to users for interactive feedback.\n\n* Optimized Management Interface:\n\n      Building on the foundation of the three projects, DjangoAsyncAdmin is used to optimize and enhance the interaction and management pages, making it more intuitive and convenient to manage tasks and monitor progress.\n\n* Easy to Integrate and Extend:\n\n      The design of Django Celery Stack \u0026 Admin is flexible, allowing for easy integration with other Django applications and Celery components to meet various requirements.\n\n![](assets/registeredTaskList.png)\nFor both traditional web developers handling substantial data processing needs and system administrators tasked with\nintricate scheduling, this full stack solution for Celery and Django compatibility is the optimal selection.\nIt delivers a proficient and scalable framework for managing asynchronous tasks and scheduling, enhancing the\nperformance of your Django projects. Embrace this solution today and begin reaping the benefits of streamlined task\nmanagement and scheduling within your Django environment.\n\n### Usage\n\n1. Install\n    ```shell\n    pip install django-celery-stack\n    ```\n   2. Django project configuration\n\n       * Register APP (settings.py)\n         ```python\n           # Application definition\n           INSTALLED_APPS = [\n             ...\n             django_celery_stack\n             ...\n           ]\n         ```\n\n       * configure the result backend ( `settings.py` )\n           ```python\n           CELERY_RESULT_BACKEND = \"django_celery_stack.backends:CustomDatabaseBackend\"\n           ```\n       * configure the url and router ( `proj.urls.py` ):\n        \n           ```python\n           urlpatterns.append(path('celery/', include('django_celery_stack.urls')))\n           ```\n       * create a `celery.py` file under the `proj` folder:\n           ```python\n           import os\n           from celery import Celery\n           from celery.schedules import crontab\n        \n           # Set the default Django settings module for the 'celery' program.\n           os.environ.setdefault('DJANGO_SETTINGS_MODULE', '\u003cproject_name\u003e.settings')\n        \n           app = Celery('\u003cproject_name\u003e')\n        \n           # Using a string here means the worker doesn't have to serialize\n           # the configuration object to child processes.\n           # - namespace='CELERY' means all celery-related configuration keys\n           #   should have a `CELERY_` prefix.\n           app.config_from_object('django.conf:settings', namespace='CELERY')\n           app.conf.update(\n               task_time_limit=3600,  # 将任务超时时间设置为 3600 秒（1小时）\n           )\n           # Load task modules from all registered Django apps.\n           app.autodiscover_tasks(packages=['\u003csome_packages_you_registered_tasks\u003e'])\n           ```\n       * load the `celery.py` to the running. ( `proj.__init__.py` ):\n            ```python\n            from .celery import app as celery_app\n\n            __all__ = ('celery_app',)            \n            ```\n\n### Develop Plan\n\n* [ ] Implement an automatic task distribution mechanism to make task distribution more flexible and convenient.\n* [ ] Re-adjust the result management of subtasks and parent tasks.\n* [ ] Persistence and associated display of associated information between main and subtasks.\n* [ ] Refer to [celery-progress](https://github.com/czue/celery-progress)\n* [ ] Refer to [django-celery-monitor](https://github.com/jazzband/django-celery-monitor)\n\n### Develop \u0026 Contribution\n\n1. Clone the project to your local.\n    ```shell\n    git clone https://github.com/Haoke98/django-celery-stack.git\n   ```\n2. Build the package.\n    ```shell\n    python setup.py build sdist\n    ```\n3. Deploy to [PyPI](https://pypi.org).\n    ```shell\n    twine upload dist/* \n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaoke98%2Fdjango-celery-stack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaoke98%2Fdjango-celery-stack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaoke98%2Fdjango-celery-stack/lists"}