Installation¶

This guide covers various methods for installing GeoAI on different platforms with different package managers.

✅ Prerequisites¶

GeoAI requires:

Python 3.9 or above
The required dependencies will be installed automatically

🚀 Recommended Installation Methods¶

🐍 Using pip¶

The simplest way to install the latest stable release of GeoAI is via pip:

1	`pip install geoai-py`

To install GeoAI with all optional dependencies for additional features:

pip install "geoai-py[all]"

🐍 Using uv¶

To install the latest stable release of GeoAI with uv, a faster alternative to pip:

uv pip install geoai-py

🐼 Using conda¶

For Anaconda/Miniconda users, we recommend installing GeoAI via conda-forge, which handles dependencies like GDAL more elegantly:

conda install -c conda-forge geoai

🦡 Using mamba¶

Mamba provides faster dependency resolution compared to conda. This is especially useful for large packages like GeoAI:

conda create -n geo python=3.12
conda activate geo
conda install -c conda-forge mamba
mamba install -c conda-forge geoai

🔧 Advanced Installation Options¶

🖥️ GPU Support¶

To enable GPU acceleration for deep learning models (requires NVIDIA GPU):

mamba install -c conda-forge geoai "pytorch=*=cuda*"

This will install the appropriate PyTorch version with CUDA support.

If you run into issues with the ipympl package, you can install it using the following command:

mamba install -c conda-forge geoai "pytorch=*=cuda*" jupyterlab ipympl

If you encounter issues with the sqlite package, you can update it using the following command:

mamba update -c conda-forge sqlite

Notes for Windows Users¶

If you use mamba to install geoai, you may not have the latest version of torchgeo, which may cause issues when importing geoai. To fix this, you can install the latest version of torchgeo using the following command:

pip install -U torchgeo

👩‍💻 Development Installation¶

For contributing to GeoAI development, install directly from the source repository:

git clone https://github.com/opengeos/geoai.git
cd geoai
pip install -e .

The -e flag installs the package in development mode, allowing you to modify the code and immediately see the effects.

📦 Installing from GitHub¶

To install the latest development version directly from GitHub:

1	`pip install git+https://github.com/opengeos/geoai.git`

For a specific branch:

1	`pip install git+https://github.com/opengeos/geoai.git@branch-name`

✓ Verifying Installation¶

To verify your installation, run:

import geoai
print(geoai.__version__)

⚠️ Troubleshooting¶

If you encounter installation problems:

Check the FAQ section of our documentation
Search for similar issues in our GitHub Issues
Ask for help in our GitHub Discussions

🔄 Upgrading¶

To upgrade GeoAI to the latest version:

pip install -U geoai-py

Or with conda:

conda update -c conda-forge geoai