Installation#

License Python version Anaconda-Server Badge

pypi dwn conda dwn

argopy >= 1.3 requires Python 3.11

Because of a bug in xarray versions from 2024.3.0 to 2025.6.1 and since xarray >= 2025.7.0 requires python >= 3.11: argopy >= 1.3 requires Python 3.11.

Instructions#

Install the last release with conda:

conda install -c conda-forge argopy

or pip:

pip install argopy

you can also work with the ongoing development version:

pip install git+http://github.com/euroargodev/argopy.git@master

Required dependencies#

argopy >= 1.3 requires Python 3.11

  • xarray >= 2025.7.0, <=2025.9.0

  • scipy

  • numpy

  • erddapy

  • netCDF4

  • h5netcdf

  • fsspec >= 2025.5.1

  • toolz

  • requests

  • aiohttp <= 3.12.15

  • decorator

  • packaging

Requirement dependencies details can be found here.

The argopy software is continuously tested under latest OS (Linux, Mac OS and Windows) and with python versions 3.11 and 3.12.

Optional dependencies#

For a complete argopy experience, you may also consider to install the following packages:

Utilities

  • gsw

  • pyco2sys

  • tqdm

Performances

  • dask

  • distributed

  • joblib

  • numba

  • pyarrow

Files handling

  • boto3 / s3fs

  • zarr

  • numcodecs

  • kerchunk

Visualisation

  • cartopy

  • IPython

  • ipykernel

  • ipywidgets

  • matplotlib

  • pyproj

  • seaborn

Environments#

You can simply use one of the argopy testing conda environments listed here: euroargodev/argopy

You can also look at this section of the documentation Virtual environment