Kepler.gl is a powerful open source geospatial analysis tool for large-scale data sets.
kepler.gl for Jupyter
This is the kepler.gl Jupyter widget, an advanced geospatial visualization tool for rendering large-scale interactive maps in Jupyter Notebook and JupyterLab.
Installation
pip install keplergl
Prerequisites
- Python >= 3.9
- JupyterLab >= 4.0 or Notebook >= 7.0
Quick Start
from keplergl import KeplerGl
# Create a map
map = KeplerGl(height=400)
# Add data
map.add_data(data=df, name='my_data')
# Display the map
map
Features
- Multiple data formats: Load CSV, GeoJSON, Pandas DataFrame, and GeoPandas GeoDataFrame
- GeoArrow support: Use
use_arrow=Truefor faster data loading and rendering with large datasets - GeoDataFrame datetime support: GeoDataFrames with
datetimecolumns are serialized automatically — no manual conversion needed - Empty geometry handling: GeoDataFrames with empty or all-null geometry columns are handled gracefully
- Theme customization: Set the UI theme to
"light","dark", or"base"via thethemeparameter - App name customization: Set a custom application name with
app_name— displayed in the side panel header and used as the HTML<title>when exporting - HTML export: Export maps to standalone HTML files with
save_to_html(), supporting custom themes, app names, and a configurable JSON encoder for non-native types
Documentation
For full documentation, visit https://docs.kepler.gl/docs/keplergl-jupyter.
AI Assistant Skill Setup
If you use AI coding assistants, add your project skill/instructions file in this directory:
- Claude Code:
CLAUDE.md - Codex-compatible tools:
AGENTS.mdfor workspace-wide instructions.agents/skills/<skill-name>/SKILL.mdfor reusable Codex skills
You can keep CLAUDE.md and AGENTS.md content aligned so both tools use the same project guidance.
For Codex skills, a minimal structure is:
.agents/skills/keplergl-python/
├── SKILL.md
├── assets/
│ ├── keplergl-icon-small.svg
│ └── keplergl-icon-large.png
└── agents/
└── openai.yaml
You can source icon assets from existing repository art, for example:
website/src/static/favicon.png
And reference them in .agents/skills/<skill-name>/agents/openai.yaml:
interface:
icon_small: "../assets/keplergl-icon-small.svg"
icon_large: "../assets/keplergl-icon-large.png"
License
MIT