celery-types
Type stubs for Celery and its related packages
Decision gist · record as of 2026-08-14
Yes, if you use Celery or its related packages and want static type checking. The package is actively maintained, has no vulnerabilities, installs with minimal friction, and is permissively licensed. The required monkey-patch is a one-time setup documented in the README. Install it as a dev dependency to catch type errors early.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Monkey patching of Celery classes is necessary to use generic type parameters with these stubs.
- Installs with minimal friction—a pure Python wheel with only typing-extensions as a runtime dependency.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restriction.
last release 2026-03-12 (155 days) · last repo commit 2026-07-29 · 156 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,537,228 downloads/mo, #2,587 on PyPI
Alternatives
Verify before relying
pip install celery-types
from celery import Celery
from celery.app.task import Task
# Monkey patch to enable generic parameters (see docs for full class list)
setattr(Celery, "__class_getitem__", classmethod(lambda cls, *args, **kwargs: cls))
setattr(Task, "__class_getitem__", classmethod(lambda cls, *args, **kwargs: cls))- Whether the monkey-patch workaround is required for all use cases or only when using generic type parameters.
- Coverage completeness: which Celery and related package APIs are fully typed versus partially stubbed.
What it is and what it does
celery-types is a type-stub package that adds static type information to Celery and its ecosystem of related libraries. It enables type checkers like mypy and basedpyright to understand the APIs of Celery, kombu, amqp, billiard, vine, django-celery-results, and ephem, catching type errors at development time rather than runtime.
The package is pure stubs—it contains no runtime code and depends only on typing-extensions. Installation is straightforward, but the stubs require a monkey-patch workaround to support generic type parameters on key Celery classes like Task, AsyncResult, and Signature. This is a one-time setup step documented in the package's README.
Use it for
- Add type checking to a Celery application to catch task signature and result-handling errors before deployment.
- Enable IDE autocomplete and type hints for Celery task definitions and async result operations.
- Validate kombu message broker interactions and amqp protocol usage in type-safe code.
- Support mypy or basedpyright in a Django project using django-celery-results for task result storage.
- Integrate Celery into a strictly typed codebase without disabling type checking for Celery imports.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Celery or its related packages and want static type checking.
The package is actively maintained, has no vulnerabilities, installs with minimal friction, and is permissively licensed. The required monkey-patch is a one-time setup documented in the README. Install it as a dev dependency to catch type errors early.
Install
celery-types on PyPI
Before you install
Installs with minimal friction—a pure Python wheel with only typing-extensions as a runtime dependency. Actively maintained with a recent release and no known vulnerabilities.
Requires Python 3.10 or later. Monkey patching of Celery classes is necessary to use generic type parameters with these stubs.
License in practice
Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restriction.
Quickstart
pip install celery-types
from celery import Celery
from celery.app.task import Task
# Monkey patch to enable generic parameters (see docs for full class list)
setattr(Celery, "__class_getitem__", classmethod(lambda cls, *args, **kwargs: cls))
setattr(Task, "__class_getitem__", classmethod(lambda cls, *args, **kwargs: cls))Verify before relying
- Whether the monkey-patch workaround is required for all use cases or only when using generic type parameters.
- Coverage completeness: which Celery and related package APIs are fully typed versus partially stubbed.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <4,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetyping-extensions |
| Maintenance | Actively maintained 155 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,537,228 / month, #2,587 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Typing :: Stubs OnlyTyping :: Typed |
Evidence: celery_types-0.26.0-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 › “celery type stubs”
- celery-typesProvides type stubs for Celery and related packages (kombu, amqp,…
- celery-stubsProvides type stubs for Celery to enable static type checking with…
- pylint-celeryA Pylint plugin that improves static analysis of Celery code by…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also msgpack-types · celery-stubs · djangorestframework-types · django-types · django-stubs-ext · django-celery-results · types-smorest · google-api-python-client-stubs · types-sqlalchemy-utils · types-pysaml2