copernicusmarine
Command line interface and Python API for accessing Copernicus Marine data and related services.
Decision gist · record as of 2026-08-14
Yes, if you work with Copernicus Marine oceanographic data. Install friction is low, maintenance is active, and there are no known vulnerabilities. The main gotchas are the Python 3.10+ requirement, the xarray/numpy compatibility caveat, and unclear license metadata—verify the EUPL terms apply to your use case before deploying in production.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >=3.10.
- Copernicus Marine account credentials needed for data access.
- xarray<2024.7.0 with numpy>=2.0.0 causes inconsistent results.
License · maintenance · safety
(unclear) — License treatment is unclear—the package references EUPL in its description but metadata lacks explicit SPDX or raw license fields. Verify licensing terms before use in proprietary or restricted contexts.
last release 2026-05-11 (95 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 232,927 downloads/mo, #9,052 on PyPI
Alternatives
Verify before relying
pip install copernicusmarine
import copernicusmarine
# List available datasets
copernicusmarine.describe()
# Download a subset as NetCDF
copernicusmarine.subset(dataset_id="...", variables=[...], output_filename="subset.nc")- Whether Copernicus Marine account creation and login are required before any data access, or if public datasets are available without authentication.
- Performance characteristics and typical download speeds for large datasets or subsetting operations.
- Whether the package handles authentication caching or if credentials must be supplied on each call.
What it is and what it does
Copernicusmarine is a Python package and command-line tool that connects to the Copernicus Marine Service to access oceanographic datasets. It lets you list and retrieve metadata for all available marine products and datasets, apply filters to find specific data, and download subsets in formats like NetCDF or Zarr without quotas on volume or bandwidth.
The package wraps the Marine Data Store API, exposing both a CLI (via click) and a Python API. It depends on a substantial stack including xarray, dask, zarr, and boto3 for data handling and cloud storage, plus pydantic for validation and pystac for catalog metadata. The main constraint is a Python version requirement of 3.10 or higher, and a known incompatibility between older xarray and numpy 2.0+.
Use it for
- Download oceanographic model outputs or observational data for a specific geographic region and time period.
- Subset large marine datasets to NetCDF or Zarr format before processing in a local analysis pipeline.
- Automate recurring data fetches from Copernicus Marine in a scheduled workflow or batch job.
- Query the full Copernicus Marine catalog to discover available variables and products programmatically.
- Access cloud-optimized Zarr stores directly for analysis with dask on distributed compute.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you work with Copernicus Marine oceanographic data.
Install friction is low, maintenance is active, and there are no known vulnerabilities. The main gotchas are the Python 3.10+ requirement, the xarray/numpy compatibility caveat, and unclear license metadata—verify the EUPL terms apply to your use case before deploying in production.
Install
copernicusmarine on PyPI
Before you install
Low install friction with a pure-wheel distribution. Active maintenance as of 95 days ago. Supports Python 3.10 through 3.14. Note: the package documentation warns that xarray<2024.7.0 combined with numpy>=2.0.0 produces inconsistent results.
Requires Python >=3.10. Copernicus Marine account credentials needed for data access. xarray<2024.7.0 with numpy>=2.0.0 causes inconsistent results.
License in practice
License treatment is unclear—the package references EUPL in its description but metadata lacks explicit SPDX or raw license fields. Verify licensing terms before use in proprietary or restricted contexts.
Quickstart
pip install copernicusmarine
import copernicusmarine
# List available datasets
copernicusmarine.describe()
# Download a subset as NetCDF
copernicusmarine.subset(dataset_id="...", variables=[...], output_filename="subset.nc")Verify before relying
- Whether Copernicus Marine account creation and login are required before any data access, or if public datasets are available without authentication.
- Performance characteristics and typical download speeds for large datasets or subsetting operations.
- Whether the package handles authentication caching or if credentials must be supplied on each call.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 13 packagesclickrequestsxarraytqdmzarrdaskboto3semverpystacnumpypydantich5netcdfarcosparse |
| Maintenance | Actively maintained 95 days since the last release |
| First released | |
| Downloads | 232,927 / month, #9,052 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: copernicusmarine-2.4.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “copernicus marine data download”
- copernicusmarineCopernicusmarine provides a CLI and Python API to query, filter, and…
- arcosparseDownloads and subsets sparse geospatial datasets stored in ARCO…
- cdsapicdsapi is a Python client for the Copernicus Climate Data Store API,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Information Analysis packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyarrow provides Python bindings to Apache Arrow's C++ libraries for efficient columnar data processing, serialization, and interoperability with pandas, NumPy, and other Python ecosystem tools.
NetworkX provides data structures and algorithms for creating, analyzing, and manipulating graphs and networks, supporting everything from simple undirected graphs to complex directed and weighted networks.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
ContourPy calculates contours of 2D quadrilateral grids using C++11 algorithms wrapped in Python, offering serial and multithreaded implementations without requiring Matplotlib as a dependency.
Snowpark Python provides APIs to query and process data directly in Snowflake without moving data to your local system, with support for both native Snowpark and pandas-compatible interfaces.
Install it if you use Snowflake and want to process data without moving it to your application layer.
See also arcosparse · cdsapi · earthkit-data · gsw · cfgrib · cmocean · kerchunk · netCDF4 · herbie-data · google-cloud-quotas