Skip to main content

mapli logo

mapli is a Python package that renders MapLibre styles to PNG images. Rendering is done by MapLibre Native, which mapli runs inside the Python process through the maplibre_native Rust crate.

mapli renders static map images, given a center and zoom level or a bounding box, and map tiles in the XYZ tiling scheme. Render calls are available as blocking and as async methods. Data can also be served to MapLibre Native from Python, through custom URL scheme handlers.

Documentation: https://geobeyond.github.io/mapli/

Installation

mapli is published on PyPI:

uv add mapli
pip install mapli

mapli currently runs on Linux only (x86_64 and ARM64, glibc 2.34 or newer). Rendering needs an EGL driver, libcurl and a display (or Xvfb), see System requirements.

Usage

from pathlib import Path

import mapli

pool = mapli.RenderPool(workers=2)
pool.register_style("demo", url="https://demotiles.maplibre.org/style.json")

png_bytes = pool.render("demo", lon=-9.14, lat=38.72, zoom=5, width=512, height=512)
Path("lisbon.png").write_bytes(png_bytes)

Development

See Development in the documentation.

License

See LICENSE.

Metadata

Release files for mapli 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mapli 0.5.0
File Size Uploaded Provenance Actions
mapli-0.5.0.tar.gz 24.5 MB With provenance Details for mapli-0.5.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for mapli 0.5.0
File Interpreter ABI Platform Actions
mapli-0.5.0-cp39-abi3-manylinux_2_34_x86_64.whl CPython 3.9 abi3 Linux glibc 2.34+ x86-64 Details for mapli-0.5.0-cp39-abi3-manylinux_2_34_x86_64.whl
mapli-0.5.0-cp39-abi3-manylinux_2_34_aarch64.whl CPython 3.9 abi3 Linux glibc 2.34+ ARM64 Details for mapli-0.5.0-cp39-abi3-manylinux_2_34_aarch64.whl

Total release size: 69.6 MB

Release files / mapli-0.5.0.tar.gz

Download URL mapli-0.5.0.tar.gz
Size 24.5 MB
Tags Source
SHA-256 checksum
How to use checksums
a99f4a9a9855dca828220c10c9e729835b1801c132db04cb3f6c8cbfe912c24b
BLAKE2b-256 checksum
How to use checksums
00dcf0ecaa6f08c274d8295f9fba5b25a8be86a348f208677f4be659bb865247
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / mapli-0.5.0-cp39-abi3-manylinux_2_34_x86_64.whl

Download URL mapli-0.5.0-cp39-abi3-manylinux_2_34_x86_64.whl
Size 22.9 MB
Tags CPython 3.9 Linux glibc 2.34+ x86-64 abi3
SHA-256 checksum
How to use checksums
3233570f57df1e86b7d53910af543ca00c9a7d2b3c0c108eed7e99ccdae8c6c0
BLAKE2b-256 checksum
How to use checksums
9264f11836300f16b296566e1c244e5190e37270d0fd327f67859fd5416f79b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / mapli-0.5.0-cp39-abi3-manylinux_2_34_aarch64.whl

Download URL mapli-0.5.0-cp39-abi3-manylinux_2_34_aarch64.whl
Size 22.3 MB
Tags CPython 3.9 Linux glibc 2.34+ ARM64 abi3
SHA-256 checksum
How to use checksums
c2e2961f7a48d3bbce86c9ec93c03c7a962e6266215bf2695ad6343d5aa19b09
BLAKE2b-256 checksum
How to use checksums
481978e3339d131ba9ce169394d0f325125c81d6e4cabec2bc37632409d45f55
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Security for mapli 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 3 files in this release have been uploaded with provenance metadata.

Select from 3 files

Attestation for mapli-0.5.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.0 This release

3 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page