---
id: joblib-stubs
version: "1.5.3.1.20260117"
license: MIT
license_treatment: permissive
maintenance: active
---

# joblib-stubs — joblib stubs

License: permissive · Maintenance: active · Downloads: 109.6K/mo

## What it is and what it does

joblib-stubs is a type stub package that teaches static type checkers how to understand joblib's public API. It contains no runtime code—only type annotations and signatures. When installed alongside joblib, type checkers like mypy can now infer correct types for joblib functions like Parallel and delayed, catching type errors at analysis time rather than runtime.

The package is designed for developers who use joblib for parallel computing and want static type safety in their codebase. It supports Python 3.11 through 3.14 and depends only on typing-extensions. The stubs do not cover joblib.externals (bundled cloudpickle and loky), so type checking for those modules remains unavailable.

Use it for:

- Enable mypy or other type checkers to validate joblib usage in a data processing pipeline
- Catch type mismatches in Parallel and delayed calls before runtime
- Improve IDE autocomplete and inline documentation for joblib functions
- Maintain type safety in a large codebase that uses joblib for distributed computation

## Worth the install?

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

Provides type stubs for joblib, enabling static type checkers to understand joblib's API and type signatures without runtime code.

Yes, if you use joblib and want static type checking. Install it alongside joblib to enable type checkers to understand joblib's API. The package is lightweight, actively maintained, and has no security vulnerabilities. It imposes no runtime overhead since it contains only type information.

## Install

pip install joblib-stubs
uv add joblib-stubs
poetry add joblib-stubs

## Installing joblib-stubs

Before you install: Low friction installation with a single lightweight dependency (typing-extensions). Repository is actively maintained with recent commits, though the project is relatively young with modest adoption.

License in practice: MIT license is permissive and imposes no restrictions on use, modification, or distribution in your own projects.

Quickstart:

pip install joblib-stubs

from joblib import Parallel, delayed
results = Parallel(n_jobs=2)(delayed(lambda x: x**2)(i) for i in range(10))
# Type checker now understands joblib's types

Requires joblib to be installed separately for runtime; stubs alone provide no execution capability. Requires Python 3.11 or later.

Verify before relying:

- Completeness of type coverage for all joblib modules and functions beyond externals
- Compatibility with type checkers other than mypy (pyright, pyre, etc.)
- Whether stub coverage keeps pace with joblib's own API evolution

## Package facts

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

## Tags

joblib type stubs, joblib type hints, static type checking joblib, joblib typing support, type annotations for joblib, joblib mypy stubs, joblib type checker support, type-stubs, static-analysis

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