Installation

Prerequisites

• Python 3.11 or later

All the geospatial dependencies (GeoPandas, Shapely, Fiona, Rasterio, OpenCV, …) ship as prebuilt wheels and are installed automatically.

Install shapelib

Directly from the repository:

pip install "shapelib @ git+https://github.com/g-e-o-i-a/shapelib.git"

Or from a local clone (useful for development):

git clone https://github.com/g-e-o-i-a/shapelib.git
cd shapelib
pip install -e .

Note

shapelib is a private GeoIA package — the environment doing the pip install needs git access to the repository (e.g. an SSH key or a GitHub token).

The install builds a small Cython extension used by the raster-to-lines converter; this happens automatically and requires no system packages.

Verify the installation

import shapelib

print(shapelib.__version__)

If the import works, head to the Quickstart to read your first file.