---
id: celery-stubs
version: "0.1.3"
license: MIT License
license_treatment: permissive
maintenance: abandoned
---

# celery-stubs — celery stubs

License: permissive · Maintenance: abandoned · Downloads: 538.4K/mo

## What it is and what it does

celery-stubs is a type stub package that provides type annotations for Celery. It allows developers using mypy or other static type checkers to catch type errors in Celery code at development time rather than at runtime. The package depends on mypy and typing-extensions.

The package is in alpha status and has been abandoned since late 2023, with no active maintenance. It was last released on 2023-02-10 and the repository is archived. While it carries no known security vulnerabilities, its lack of maintenance means it may not reflect recent Celery API changes.

Use it for:

- Enable mypy type checking on Celery task definitions and worker code in existing projects
- Catch type mismatches in Celery task signatures and return types before runtime
- Integrate Celery into a type-safe Python codebase that uses static type checking

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for Celery to enable static type checking with mypy on Celery code.

Yes, but with caution: install only if you need type stubs for Celery in an existing codebase and are comfortable with an abandoned package that will not receive updates. The low install friction and permissive license make it safe to try, but verify compatibility with your Celery version.

## Install

pip install celery-stubs
uv add celery-stubs
poetry add celery-stubs

## Installing celery-stubs

Before you install: Installation is straightforward with low friction, but the package is archived and abandoned as of late 2023, with no commits or maintenance for over a year.

License in practice: MIT License permits unrestricted use, modification, and distribution with minimal restrictions.

Quickstart:

pip install celery-stubs

import celery
from celery import Celery

app = Celery()

Verify before relying:

- Whether these stubs remain compatible with current Celery versions and their type coverage
- Whether mypy and typing-extensions have minimum or maximum version constraints

## Package facts

- License: MIT License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 538.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

celery type stubs, celery mypy support, celery type hints, static type checking celery, celery typing, celery type annotations, type-stubs, mypy, abandoned

[View on SkillFed](https://skillfed.io/packages/celery-stubs) · [View on PyPI](https://pypi.org/project/celery-stubs/)