geolibre-wasm (Python)
Run the geolibre-rust geospatial
tool suite (the whitebox_next_gen tools plus GeoLibre's own) from Python. The
tools are a single WebAssembly (WASI) module executed in-process via
wasmtime, so there is no
native install, no GDAL, and no server — just pip install.
This mirrors the JavaScript geolibre-wasm/tools API (list_tools,
list_manifests, run_tool), so the two stay in sync.
The import package is
geolibre_wasm(the distribution isgeolibre-wasm), matching the npm package name and avoiding a clash with the separategeolibreapplication package.
Install
pip install geolibre-wasm
On first use the runtime (geolibre-cli.wasm, ~20 MB) is downloaded from the
matching GitHub release and cached under ~/.cache/geolibre/. To use a local
copy instead, set GEOLIBRE_WASM=/path/to/geolibre-cli.wasm or pass
wasm_path= to any call.
Usage
Inputs are placed under /work; the tool reads/writes there and any new files
come back as bytes. Each input value may be bytes, an http(s) URL
to download, or a local file path -- the same for raster and vector inputs:
res = gl.run_tool(
"write_geoparquet",
args=["--input=/work/in.geojson", "--output=/work/out.parquet"],
input={"in.geojson": "https://example.com/data/cities.geojson"}, # fetched for you
)
This downloads the whole file (no HTTP range reads). Works for cog.tif,
data.parquet, data.fgb, data.geojson, etc.
Paths are sandboxed. Every path inside
argsrefers to the tool's/workfilesystem, not your host disk.inputfiles are placed at/work/<name>, andres.fileskeys are paths relative to/work. Do your ownopen()/write()against host paths (e.g./content/...on Colab) on the Python side, never insideargs.
import geolibre_wasm as gl
# Discover tools (each manifest carries a "source": "geolibre" | "whitebox")
tools = gl.list_tools()
manifests = gl.list_manifests()
# Raster: compute slope from a DEM
dem = open("dem.tif", "rb").read() # read from host disk
res = gl.run_tool(
"slope",
args=["--input=/work/dem.tif", "--output=/work/slope.tif", "--units=degrees"],
input={"dem.tif": dem}, # -> /work/dem.tif
)
assert res.exit_code == 0, res.stdout # surfaces tool errors
open("slope.tif", "wb").write(res.files["slope.tif"]) # key is relative to /work
# Reproject (warp) to a target EPSG
res = gl.run_tool(
"reproject_raster",
args=["--input=/work/dem.tif", "--output=/work/wgs84.tif", "--epsg=4326"],
input={"dem.tif": dem},
)
# Vector: GeoJSON -> GeoParquet (Hilbert-sorted, bbox covering, ZSTD by default)
gj = open("cities.geojson", "rb").read()
res = gl.run_tool(
"write_geoparquet",
args=["--input=/work/in.geojson", "--output=/work/out.parquet"],
input={"in.geojson": gj},
)
open("cities.parquet", "wb").write(res.files["out.parquet"])
Tools that write a directory tree (e.g. raster_to_tiles) return nested keys:
res = gl.run_tool(
"raster_to_tiles",
args=["--input=/work/dem.tif", "--output_dir=/work/tiles", "--min_zoom=16", "--max_zoom=18"],
input={"dem.tif": dem},
)
for path, data in res.files.items():
# e.g. "tiles/16/9559/32767.png"
...
API
list_tools(wasm_path=None) -> list[str]list_manifests(wasm_path=None) -> list[dict]run_tool(tool, args=None, input=None, wasm_path=None) -> ToolResultToolResult(exit_code: int, stdout: list[str], files: dict[str, bytes])runtime_path(wasm_path=None) -> str— resolve the runtime (explicit >GEOLIBRE_WASM> cached download)download_runtime(dest=None) -> str— fetch the runtime ahead of time
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for geolibre-wasm 1.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| geolibre_wasm-1.6.0.tar.gz | 8.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| geolibre_wasm-1.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.1 kB
Release files / geolibre_wasm-1.6.0.tar.gz
| Download URL | geolibre_wasm-1.6.0.tar.gz |
|---|---|
| Size | 8.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5aff8d9ae69f96df49e5e5902f2c018cb202ca16822ae83076e8e08f82a51c8c
|
|
BLAKE2b-256 checksum How to use checksums |
93363473188a9c91167fe53ddb5be13d7bade24412aacd758f8b4831a1630a17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 11, 2026.
Transparency logRelease files / geolibre_wasm-1.6.0-py3-none-any.whl
| Download URL | geolibre_wasm-1.6.0-py3-none-any.whl |
|---|---|
| Size | 8.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
59b8113a72118e521d0fe85a677ccbaf883d6f3b3427b2ed3b59832031bc9932
|
|
BLAKE2b-256 checksum How to use checksums |
3efc7148aae7493874e827033191279b43279da22cd827297af14979a42cbb92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 11, 2026.
Transparency log
