earthaccess

library0.18.0pypypi✓ verified 85d ago

Client library for NASA Earthdata APIs. Provides authenticated search, access, and streaming of NASA Earth science data via Earthdata Login. Current version: 0.17.0. Releases on a monthly cadence.

data

pip install earthaccess

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · EARTHACCESS

earthaccess

datapythonv0.18.0

Install

7.7s avg

Import

1544ms

Disk

81MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.14.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.612s · 64.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 7.7s · import 1.476s · 67MB

81MB installed

● package 81MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

earthaccess

✓ import earthaccess

The library is imported as a module; no submodule import needed.

earthaccess.login

✓

✗ from earthaccess import auth; auth.login()

Use earthaccess.login() directly; the old auth submodule is deprecated.

earthaccess.open

✓

✗ earthaccess.open_files()

open_files() was renamed to open() in a previous version.

Authenticate, search for ICESat-2 ATL06 granules, and open remote file handles.

import earthaccess auth = earthaccess.login() results = earthaccess.search_data( short_name='ATL06', bounding_box=(-180, -90, 180, 90), count=10 ) files = earthaccess.open(results)

Debug

Known issues

breakingIn v0.14.0, earthaccess.login() now raises an exception on rejected credentials instead of printing a warning. Code that ignored login failures will break.

fix

Wrap in try/except: try: earthaccess.login() except Exception: print('Login failed')

affects: >=0.14.0

deprecatedearthaccess.open_virtual_dataset() and open_virtual_mfdataset() are deprecated in v0.17.0 ahead of v1.0. They are replaced by the unified .virtualize() method.

fix

Use .virtualize() on the store object instead.

affects: >=0.17.0

gotchaearthaccess.open() returns fsspec file objects, not xarray Datasets. You must pass them to xarray.open_dataset() or use .virtualize().

fix

Use xarray.open_dataset(earthaccess.open(results)[0]) to get an xarray Dataset.

affects: all

Errors

Common errors & fixes

AttributeError: module 'earthaccess' has no attribute 'open_files'

The function was renamed from open_files to open in an earlier version.

fix

Use earthaccess.open() instead.

earthaccess.exceptions.AuthenticationError: Earthdata Login credentials rejected

Credentials are invalid or expired. Since v0.14.0, this raises an exception.

fix

Check your .netrc file or environment variables (EARTHDATA_USERNAME, EARTHDATA_PASSWORD). Or call earthaccess.login(strategy='netrc') to force netrc usage.

Upgrade

Version history

0.18.0latest on PyPI · released May 12, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/earthaccess-dev/earthaccess ↗

packagehttps://pypi.org/project/earthaccess/ ↗

docshttps://earthaccess.readthedocs.io ↗

changeloghttps://github.com/earthaccess-dev/earthaccess/blob/main/CHANGELOG.md ↗