---
id: ipyleaflet
version: "0.20.0"
license: The MIT License (MIT) Copyright (c) 2014-2018, Project Jupyter Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# ipyleaflet — A Jupyter widget for dynamic Leaflet maps

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

## What it is and what it does

ipyleaflet is a Python widget that bridges Jupyter notebooks with the Leaflet JavaScript mapping library, letting you create and interact with geographic maps directly in notebook cells. It wraps Leaflet's functionality—basemaps, GeoJSON overlays, markers, popups, and drawing tools—as interactive Python objects you can manipulate from code.

The package depends on ipywidgets for the notebook widget framework, branca for map rendering, traittypes for type validation, xyzservices for tile provider management, and jupyter-leaflet for the front-end component. It supports Python 3.8, 3.9, 3.10, 3.11, and 3.12, and is actively maintained by the Jupyter project.

Use it for:

- Explore and visualize geographic datasets interactively in research notebooks without leaving the Jupyter environment.
- Build choropleth maps to display regional statistics or survey results with color-coded regions.
- Compare two map views side-by-side using the splitmap control to highlight changes or differences.
- Overlay velocity or flow data on a map to visualize patterns in geographic space.
- Prototype geospatial analysis workflows by combining map interaction with Python data processing.

## Worth the install?

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

ipyleaflet embeds interactive Leaflet maps directly into Jupyter notebooks, letting you display and manipulate geographic data with mouse and keyboard controls.

Yes. ipyleaflet is actively maintained, has no known vulnerabilities, installs with low friction, and is licensed permissively. It fills a clear need for interactive geographic visualization in Jupyter notebooks. Install it if you work with geographic data in notebooks.

## Install

pip install ipyleaflet
uv add ipyleaflet
poetry add ipyleaflet

## Installing ipyleaflet

Before you install: Installation is straightforward with low friction; the package is actively maintained with recent commits and a stable release cycle.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for commercial and open-source projects alike.

Quickstart:

pip install ipyleaflet

from ipyleaflet import Map
m = Map()
m

Requires Jupyter notebook or compatible environment; ipywidgets must be installed and enabled in the notebook kernel.

Verify before relying:

- Whether the package works with JupyterLab in addition to classic Jupyter notebooks
- Performance characteristics when rendering large GeoJSON datasets or many map layers
- Extent of built-in basemap providers and whether additional tile sources can be added

## Package facts

- License: The MIT License (MIT) Copyright (c) 2014-2018, Project Jupyter Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 485.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jupyter interactive maps, leaflet maps in notebook, geospatial visualization jupyter, interactive geographic data, jupyter widget mapping, leaflet bridge jupyter, notebook map visualization, geospatial, jupyter-widget, interactive-visualization

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