# python-visualization/folium

Python Data. Leaflet.js Maps.

Repository: https://github.com/python-visualization/folium
Canonical: https://ross.abutalabs.com/products/folium
Homepage: https://python-visualization.github.io/folium/
Language: Python
License: NOASSERTION
License Family: other
Topics: data-science, data-visualization, javascript, maps, python
Last push: 2026-08-25T14:04:57+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 40, longevity 100
- inputs: {"age_days": 4864, "days_push": 8, "days_rel": 443, "gap_med": 15, "n_releases_24m": 10}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7394, forks 2262 (observed 2026-08-28T04:09:59.642735+00:00)

## What it is
Folium is a Python library that makes it easy to visualize geospatial data on interactive Leaflet.js maps. Users manipulate data in Python (pandas, GeoJSON) and render it as rich, interactive HTML maps with markers, choropleths, and tile layers.

## Use cases
- plot points on an interactive map from a pandas dataframe
- create a choropleth map of country statistics
- visualize geo data in a jupyter notebook
- embed an interactive map in a streamlit app
- add markers and popups to a leaflet map from python
- render large geo feature collections on a map

## When to choose
- you want interactive slippy maps driven by Python data
- you work in Jupyter notebooks or data-science pipelines with geospatial data
- you want Leaflet.js features without writing JavaScript

## When to avoid
- you need static publication-quality maps (use matplotlib/cartopy or geopandas plotting)
- you need a full GIS application or heavy 3D globe rendering
- you are building a non-Python JavaScript mapping app directly

## Facets
- artifact type: library
- maturity: stable
- function: data-visualization, geospatial, charts
- domain: data-visualization, data-science
- platform: python, cross-platform
- tags: leaflet, maps, interactive-maps, jupyter, geo, geospatial

## Member repositories
- python-visualization/folium (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:59.642735+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:38:04.891386+00:00, confidence not recorded.
  - readme: https://github.com/python-visualization/folium (fetched 2026-08-28T04:09:59.642735+00:00, sha ee164827ab2d)
  - homepage: https://python-visualization.github.io/folium/ (fetched 2026-08-29T08:33:35.759791+00:00, sha 21d7c6e5e228)
  - registry_pypi: https://pypi.org/pypi/folium/json (fetched 2026-08-29T08:33:35.769479+00:00, sha 4cb46fc88fd2)
- Data as of 2026-08-30T08:39:29.467469+00:00.