---
id: types-shapely
version: "2.1.0.20260728"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-shapely — Typing stubs for shapely

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

## What it is and what it does

types-shapely is a type stub package that bridges the gap between shapely's geometric library and Python's static type checkers. It provides type annotations for shapely's API, allowing tools like mypy, pyright, and ty to catch type errors in code that uses shapely for geometric operations. The stubs are maintained as part of the typeshed project and are tested against multiple type checkers to ensure accuracy.

This package is a pure annotation layer—it has no runtime behavior and does not replace shapely itself. You install it alongside shapely to enable type checking during development. It depends only on numpy, matching shapely's own dependency, and requires Python 3.10 or later.

Use it for:

- Enable mypy or pyright to type-check code that creates and manipulates geometric objects with shapely
- Catch type mismatches in shapely function calls before runtime in a CI/CD pipeline
- Provide IDE autocomplete and type hints for shapely methods in editors that support type stubs
- Validate geometric coordinate and geometry object types in data processing pipelines

## Worth the install?

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

Provides type stubs for the shapely package, enabling static type checkers like mypy and pyright to validate code that uses shapely's geometric operations.

Yes, if you use shapely and want static type checking. Install it as a development dependency alongside shapely 2.1.*. It has no runtime cost, low friction, and is actively maintained by typeshed. No security concerns. Only skip it if you do not use a type checker or do not use shapely.

## Install

pip install types-shapely
uv add types-shapely
poetry add types-shapely

## Installing types-shapely

Before you install: Low friction installation with a single runtime dependency on numpy. Actively maintained with recent releases; last commit within days of the package version date.

License in practice: Apache-2.0 permissive license allows use in most projects, including proprietary software, with minimal restrictions.

Quickstart:

pip install types-shapely

import shapely.geometry
from shapely.geometry import Point

p = Point(0, 0)

Requires Python 3.10 or later; intended for use with shapely 2.1.* versions.

Verify before relying:

- Whether these stubs are automatically kept in sync with shapely releases or require manual updates
- Coverage completeness for all shapely 2.1.* APIs beyond what the tested type checkers verify

## Package facts

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

## Tags

shapely type stubs, shapely type hints, static type checking shapely, mypy shapely annotations, pyright shapely types, shapely typing support, geometric library type checking, type-stubs, static-typing

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