# Celery

Distributed Task Queue (development branch)

Repository: https://github.com/celery/celery
Canonical: https://ross.abutalabs.com/products/celery
Homepage: https://docs.celeryq.dev
Language: Python
License: NOASSERTION
License Family: other
Topics: python, task-manager, task-scheduler, task-runner, queue-workers, queued-jobs, queue-tasks, amqp, redis, sqs, sqs-queue, python3, python-library, redis-queue
Last push: 2026-08-26T22:12:46+00:00
Link (homepage): https://docs.celeryq.dev
Link (site_page): https://docs.celeryq.dev/en/stable/getting-started/resources.html
Link (site_page): https://docs.celeryq.dev/en/stable/getting-started/first-steps-with-celery.html
Link (site_page): https://docs.celeryq.dev/en/stable/faq.html
Link (site_page): https://docs.celeryq.dev/en/stable/getting-started/index.html

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 76, longevity 100
- inputs: {"age_days": 6340, "days_push": 7, "days_rel": 160, "gap_med": 29, "n_releases_24m": 8}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 28826, forks 5142 (observed 2026-08-28T04:11:52.900002+00:00)

## What it is
Celery is a Python distributed task queue for processing large volumes of messages asynchronously, with support for real-time task execution and scheduled (periodic) tasks. It uses pluggable brokers like RabbitMQ, Redis, and Amazon SQS, and includes worker processes, result backends, and workflow orchestration primitives.

## Use cases
- run background jobs from a web request
- schedule periodic tasks in Python
- distribute work across multiple worker machines
- retry failed tasks asynchronously
- process emails or reports after a web request finishes
- queue heavy image or video processing jobs
- build distributed parallel execution pipelines

## When to choose
- you need a battle-tested, production-grade task queue in Python
- you want broker flexibility (RabbitMQ, Redis, SQS, Kafka)
- you need periodic/scheduled tasks, e.g. with django-celery-beat
- you need horizontal scaling, routing, retries, and workflow canvases

## When to avoid
- your app runs on Windows (not officially supported)
- you need a lightweight in-process background job runner for a small app
- you want a language other than Python as the primary ecosystem (clients exist for Go/Node/Rust but are community-maintained)
- you need a broker with monitoring on experimental transports like Kafka

## Facets
- artifact type: library
- maturity: stable
- function: message-queue, scheduling, workflow-automation, concurrency, monitoring
- domain: microservices, backend, web-development
- platform: python, self-hosted
- tags: task-queue, background-jobs, celery, rabbitmq, redis, amqp, distributed-workers, periodic-tasks, django, automation, messaging, linux, macos, docker

## Member repositories
- celery/celery (main) score 91
- celery/django-celery-beat (plugin) score 81
- celery/django-celery (plugin) score 44

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:52.900002+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:53:17.310172+00:00, confidence not recorded.
  - readme: https://github.com/celery/celery (fetched 2026-08-28T04:11:52.900002+00:00, sha fb14e745ee6d)
  - homepage: https://docs.celeryq.dev (fetched 2026-08-29T07:50:39.936863+00:00, sha 367442071f05)
  - site_page: https://docs.celeryq.dev/en/stable/getting-started/resources.html (fetched 2026-08-29T07:50:39.946057+00:00, sha 10a2e1478416)
  - site_page: https://docs.celeryq.dev/en/stable/getting-started/first-steps-with-celery.html (fetched 2026-08-29T07:50:39.947776+00:00, sha 790867eb0adc)
  - site_page: https://docs.celeryq.dev/en/stable/faq.html (fetched 2026-08-29T07:50:39.949799+00:00, sha 0dbb808cdd44)
  - site_page: https://docs.celeryq.dev/en/stable/getting-started/index.html (fetched 2026-08-29T07:50:39.952264+00:00, sha 179a01b08223)
  - site_page: https://docs.celeryq.dev/en/stable/getting-started/introduction.html (fetched 2026-08-29T07:50:39.954017+00:00, sha c679002c3704)
  - site_page: https://docs.celeryq.dev/en/stable/getting-started/backends-and-brokers/index.html (fetched 2026-08-29T07:50:39.956047+00:00, sha 900596d4f730)
  - site_page: https://docs.celeryq.dev/en/stable/getting-started/next-steps.html (fetched 2026-08-29T07:50:39.957758+00:00, sha 6b35c94b13ca)
  - site_page: https://docs.celeryq.dev/en/stable/changelog.html (fetched 2026-08-29T07:50:39.960100+00:00, sha 609df9d5f45f)
- Data as of 2026-08-30T08:39:29.467469+00:00.