---
id: types-boltons
version: "26.1.0.20260724"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-boltons — Typing stubs for boltons

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

## What it is and what it does

This is a type stub package that bridges the gap between the boltons utility library and static type checkers. Type stubs are files that describe the types and signatures of a library's public API without containing runtime code, allowing tools like mypy and pyright to validate your code against boltons even if boltons itself doesn't ship with type hints. The stubs are maintained as part of the typeshed project, a centralized repository of type information for popular Python packages.

You install types-boltons alongside boltons in your development environment. Once installed, your type checker will understand boltons' APIs and catch type errors in code that uses it. The package has no runtime dependencies and is lightweight—it's purely metadata for type checkers. It's tested against recent versions of mypy and pyright to ensure accuracy.

Use it for:

- Add type checking to a project that uses boltons without waiting for boltons itself to add native type hints.
- Catch type errors in boltons utility calls (e.g., dictutils, tableutils) during CI/CD before runtime.
- Enable IDE autocomplete and type inference for boltons APIs in editors that support type stubs.
- Maintain strict type checking in a codebase that depends on boltons for data structures or utilities.

## Worth the install?

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

Provides type stubs for the boltons library, enabling static type checkers like mypy and pyright to validate code that uses boltons without requiring the library itself to be installed.

Yes, if you use boltons and want static type checking. It's a lightweight stub package with no runtime overhead, active maintenance, and permissive licensing. Install it in your development environment alongside boltons to unlock type safety for boltons code.

## Install

pip install types-boltons
uv add types-boltons
poetry add types-boltons

## Installing types-boltons

Before you install: Low friction—a pure stub package with no runtime dependencies. Released 21 days ago with active maintenance; tested against mypy 2.3.0 and pyright 1.1.411.

License in practice: Licensed under Apache-2.0 (permissive), so it can be used freely in commercial and open-source projects without significant restrictions.

Quickstart:

pip install types-boltons

# Then use boltons in your code; mypy or pyright will now type-check it:
import boltons.dictutils
d = boltons.dictutils.OrderedMultiDict()

Requires Python >=3.10; type checking requires mypy, pyright, or another compatible type checker to be installed separately.

Verify before relying:

- Whether the stubs cover all public APIs in boltons 26.1.* or only a subset.
- Whether this package is automatically kept in sync when boltons releases updates.

## Package facts

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

## Tags

type stubs boltons, boltons typing annotations, mypy boltons support, static type checking boltons, pyright boltons stubs, type-stubs, static-analysis

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