Installing eo-tides

Stable version

The latest stable release of eo-tides is:

It is compatible with the following Python versions:

eo-tides can be installed into your Python environment using either pip (the standard Python package manager), or uv (a fast Python package manager written in Rust).

Tip

We recommend installing with uv as this makes it easy to set up an isolated environment containing compatible Python packages.

Installing with pipInstalling with uv

Install eo-tides:

python3 -m pip install eo-tides[notebooks]

The code above will also install additional package dependencies required for running Jupyter Notebook code examples (including odc-stac and pystac-client for loading satellite data).

To install eo-tides with only essential package dependencies:

python3 -m pip install eo-tides

First, install uv using the method of your choice. Then:

Create a new virtual environment with your chosen version of Python:

uv venv --python 3.13

Activate your virtual environment:

Linux and macOSWindows

source .venv/bin/activate

.venv\Scripts\activate

Install eo-tides into your virtual environment:

uv pip install eo-tides[notebooks]

The code above will also install additional package dependencies required for running Jupyter Notebook code examples (including odc-stac and pystac-client for loading satellite data).

To install eo-tides with only essential package dependencies:

uv pip install eo-tides

You are now ready to run code using eo-tides! For example, you could launch your virtual environment with JupyterLab to run the example Jupyter Notebooks:

uv run --with jupyter jupyter lab

Unstable development pre-releases

Unstable development pre-releases of eo-tides are also available:

Installing with pipInstalling with uv

Install an example eo-tides pre-release (see full list here), including additional notebooks dependencies:

python3 -m pip install eo-tides[notebooks]==0.6.3.dev5

First, install uv using the method of your choice. Then:

Create a new virtual environment with your chosen version of Python:

uv venv --python 3.13

Activate your virtual environment:

Linux and macOSWindows

source .venv/bin/activate

.venv\Scripts\activate

Install an example eo-tides pre-release (see full list here), including additional notebooks dependencies:

uv pip install eo-tides[notebooks]==0.6.3.dev5

Important

Unstable development pre-releases may contain bugs and untested new features. Unless you need access to a specific unpublished feature, we recommend installing the latest stable version instead.

Advanced: Developing locally

To work on eo-tides locally, we recommend using uv.

First, install uv using the method of your choice.

Clone the eo-tides repository:

git clone https://github.com/GeoscienceAustralia/eo-tides
cd eo-tides/

Use uv sync to populate an environment with package dependencies from the eo-tides lockfile:

uv sync --all-extras

Set up pre-commit hooks:

uv run pre-commit install

We provide a pre-prepared Makefile that you can use to easily run common tasks:

# Run code quality checks
make check

# Run pytest tests
make test

# Run Jupyter notebook tests
make test-notebooks

# Build and preview documentation
make docs

Next steps

Once you have installed eo-tides, you will need to download and set up at least one tide model before you can model tides.