---
id: tippecanoe
version: "2.72.0"
license: BSD License
license_treatment: permissive
maintenance: active
---

# tippecanoe — Builds vector tilesets from large (or small) collections of GeoJSON, FlatGeobuf, or CSV features

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

## What it is and what it does

tippecanoe is a Python distribution wrapper around the tippecanoe command-line tool, which converts geographic feature data (GeoJSON, FlatGeobuf, CSV) into vector tilesets in MBTiles format. It installs as a set of console commands (tippecanoe, tile-join, tippecanoe-decode, tippecanoe-enumerate, tippecanoe-json-tool, tippecanoe-overzoom) that you run from the shell or invoke programmatically.

The package provides prebuilt binary wheels for macOS and Linux across multiple architectures, eliminating the need to compile tippecanoe yourself. It has no Python runtime dependencies, making it lightweight to install. You can use it standalone via pip, integrate it into build systems via pyproject.toml, or run it on-demand with pipx without a permanent installation.

Use it for:

- Convert large GeoJSON feature collections into optimized MBTiles for use in web mapping applications
- Build vector tilesets from CSV or FlatGeobuf data as part of a geospatial data pipeline
- Include tippecanoe in a Python project's build-system.requires to generate tiles during wheel builds
- Run tippecanoe in CI/CD workflows (e.g., GitHub Actions) without pre-installing it, using pipx
- Decode and inspect existing MBTiles or manipulate tilesets with tile-join and other bundled utilities

## Worth the install?

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

Packages the tippecanoe command-line tool as a Python package, making it installable via pip and usable in build systems to convert GeoJSON, FlatGeobuf, or CSV features into vector tilesets.

Yes, if you need to generate or manipulate vector tilesets from geographic data. The package is actively maintained, has no security vulnerabilities, carries a permissive license, and provides convenient prebuilt binaries for common platforms. Install friction is moderate but manageable; the main consideration is ensuring your target architecture has a prebuilt wheel available.

## Install

pip install tippecanoe
uv add tippecanoe
poetry add tippecanoe

## Installing tippecanoe

Before you install: Medium install friction due to binary compilation; however, prebuilt wheels are provided for macOS and Linux across most CPU architectures, making installation straightforward on supported platforms. Repository is active with recent commits.

License in practice: Permissive BSD License (BSD 2-Clause for tippecanoe itself, BSD 3-Clause for the packaging wrapper). No restrictions on commercial or proprietary use.

Quickstart:

pip install tippecanoe

After installation, run tippecanoe commands directly:
tippecanoe -o output.mbtiles input.geojson

Or use in pyproject.toml:
[build-system]
requires = ["tippecanoe"]

The Python bin directory must be on your PATH after installation, or activate a virtual environment if installing in one. Building from source requires internet access to download tippecanoe source code.

Verify before relying:

- Whether prebuilt wheels cover all intended deployment architectures beyond the listed macOS and Linux platforms
- Performance characteristics when processing very large GeoJSON or CSV datasets
- Specific version compatibility with downstream tools that consume the generated tilesets

## Package facts

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

## Tags

vector tile generation, geojson to mbtiles, tippecanoe python, tileset builder, geographic data tiling, mbtiles creation, geospatial vector tiles, geospatial, cartography, cli-tool

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