Installation

AcadGIS runs on Python 3.9+ and is published on PyPI.

pip install acadgis

That core install ships with offline sample data and the full plotting stack, so you can try everything without a download. One import gives you the whole toolkit, including re-exports of matplotlib, numpy, pandas and geopandas:

import acadgis as agis
print(agis.__version__)

Optional extras

Some features pull heavier geospatial dependencies. Install only what you need:

Extra	Command	Adds
Live download	pip install "acadgis[download]"	pygadm — boundaries for any country
Name matching	pip install "acadgis[match]"	rapidfuzz — fuzzy join for choropleths
Terrain	pip install "acadgis[terrain]"	rasterio, rioxarray — DEM shaded relief
Drainage	pip install "acadgis[drainage]"	pysheds — stream networks from a DEM
Everything	pip install "acadgis[full]"	all of the above + mapclassify

Conda users

The geospatial stack (geopandas, rasterio, shapely) installs most reliably from conda-forge. If pip struggles to build a wheel, create an environment first:

conda create -n acadgis -c conda-forge python=3.12 geopandas rasterio rioxarray
conda activate acadgis
pip install "acadgis[full]"

Bundled offline data

These ship inside the package, so the tutorials run with no network access:

• Bangladesh — admin levels 0, 1, 2
• Iraq — admin levels 0, 1
• India — admin levels 0, 1, 2
• USA — states (incl. Alaska & Hawaii)
• World — country polygons + rivers/lakes (Natural Earth)

Anything else downloads from GADM on first use and is cached locally.

Verify

import acadgis as agis

gdf = agis.load_boundaries("Bangladesh", level="district")
agis.plot(gdf, palette="spectral", title="Bangladesh — Districts")
agis.show()

If a styled map appears, you're ready — head to the Quickstart.