---
id: keplergl
version: "0.3.7"
license: unclear
license_treatment: unclear
maintenance: active
---

# keplergl — This is a simple jupyter widget for kepler.gl, an advanced geospatial visualization tool, to render large-scale interactive maps.

License: unclear · Maintenance: active · Downloads: 554.3K/mo

## What it is and what it does

Keplergl is a Jupyter widget that wraps kepler.gl, a web-based geospatial visualization engine. It lets you render interactive maps directly in notebooks, handling large point clouds, trip trajectories, and spatial aggregations without leaving your analysis environment. The widget is backed by Redux state management and can be embedded into React-Redux applications for deeper customization.

The package is designed for exploratory data analysis of geolocation datasets. You supply geographic data (typically via geopandas or pandas with geospatial columns), configure the map through widget properties, and interact with it in the notebook cell. Setup requires managing a Jupyter environment with multiple geospatial dependencies (geopandas, Shapely, pyarrow, geoarrow-pyarrow, geoarrow-pandas) and a Mapbox token.

Use it for:

- Explore GPS points or trip trajectories interactively in a notebook without exporting to a separate web application.
- Perform spatial aggregations and filtering on large geolocation datasets during exploratory analysis.
- Build reproducible geospatial analysis workflows in Jupyter that combine data wrangling with interactive visualization.
- Prototype map-based data stories or dashboards before deploying to a standalone kepler.gl application.
- Visualize geopandas GeoDataFrames with complex geometries and attributes in an interactive, zoomable map.

## Worth the install?

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

A Jupyter widget that embeds kepler.gl's interactive geospatial visualization into notebooks, enabling visual exploration of large-scale location data with spatial aggregations.

Yes, if you work with large geospatial datasets in Jupyter and need interactive visualization. The high install friction (12 dependencies) and unclear license are real friction points, so verify license compatibility and test the dependency stack in your environment first. The package is actively maintained, has no known vulnerabilities, and is popular, making it a solid choice for geospatial exploration workflows.

## Install

pip install keplergl
uv add keplergl
poetry add keplergl

## Installing keplergl

Before you install: High install friction: requires 12 runtime dependencies including Jupyter, JupyterLab, geopandas, pyarrow, and geospatial libraries. Installation complexity is substantial, but the package is actively maintained with recent commits and no known vulnerabilities.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before adopting in proprietary or restricted-license projects.

Quickstart:

pip install keplergl

from keplergl import KeplerGl
map_widget = KeplerGl(data={'my_data': gdf})
map_widget

Requires a Mapbox Access Token to render base maps; token must be provided to the widget for full functionality.

Verify before relying:

- Exact Python version support range—classifiers list versions 2 through 3.12 but requires_python is unspecified; confirm minimum version.
- Whether the package works with modern JupyterLab versions or has known compatibility constraints.
- Performance characteristics and actual limits for datasets described as 'millions of points'.
- Whether height and width properties are configurable on the widget instance.

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: high
- Maintenance: active
- Downloads: 554.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jupyter geospatial visualization, interactive map widget, large-scale location data mapping, geolocation data explorer, webgl map rendering, spatial data visualization notebook, jupyter notebook mapping, geospatial-visualization, jupyter-widget, interactive-mapping

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