marceloprates/prettymaps — explained in plain English
Analysis updated 2026-06-24
Generate custom stylized map art of any city or address for posters or social media.
Switch between named city presets to reproduce different visual map styles instantly.
Launch the built-in Streamlit web interface to generate maps in a browser without writing code.
| marceloprates/prettymaps | google-research/vision_transformer | akashsingh3031/the-complete-faang-preparation | |
|---|---|---|---|
| Stars | 12,258 | 12,518 | 11,926 |
| Language | Jupyter Notebook | Jupyter Notebook | Jupyter Notebook |
| Setup difficulty | easy | hard | easy |
| Complexity | 2/5 | 4/5 | 1/5 |
| Audience | designer | researcher | developer |
Figures from each repo's GitHub metadata at analysis time.
OpenStreetMap credit text printed on each image must be kept intact as required by the data license.
Prettymaps is a Python library that turns real map data into stylized, visually appealing images. You give it a location, such as a city name, a street address, or a pair of latitude and longitude coordinates, and it fetches the actual geographic data from OpenStreetMap (a free, community-maintained world map) and then draws a custom illustration of that area. The results show streets, buildings, water, parks, and other features rendered in a graphic style rather than a standard navigation map look. Using it requires only a single line of code: prettymaps.plot('your location here'). The library handles downloading the data and producing the image automatically. It also comes with named "presets," which are saved style configurations, so you can switch between different color schemes and visual styles without adjusting individual settings. A preset called "minimal" produces a simpler look, while other presets named after specific cities (barcelona, macao, tijuca) reproduce the styling seen in example images from those places. Beyond a one-line Python call, the library also ships with a web front-end built on a tool called Streamlit. Running that gives you a browser-based interface for generating maps without writing code. There is also a demo available on Google Colaboratory, which lets you try it in a browser without installing anything locally. The project uses OpenStreetMap data, so the author asks that the credit text printed on each output image be kept intact, as this is required by OpenStreetMap's own license. The library is released under the AGPL v3 license, which allows commercial use and modifications but requires that any modifications also be shared as open source. The README includes an explicit note that the author does not authorize use of this project to generate NFTs, though they acknowledge they cannot legally enforce that restriction.
Prettymaps is a Python library that generates stylized artistic map illustrations of any real-world location using OpenStreetMap data in a single line of code.
Mainly Jupyter Notebook. The stack also includes Python, OpenStreetMap, Streamlit.
Use freely including commercially, but any modifications must be released as open source under the same AGPL v3 license.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly designer.
This repo across BitVibe Labs
Verify against the repo before relying on details.