earthaccess

Search, download or stream NASA Earth science data with just a few lines of code.
https://github.com/earthaccess-dev/earthaccess

Category: Sustainable Development
Sub Category: Data Catalogs and Interfaces

Keywords

access climate-data cloud-computing cmr data gis nasa nasa-api nasa-data open-science openscience pangeo remote-sensing

Keywords from Contributors

icesat-2 closember zarr cryosphere glacier 2023-hackweek jupyterbook community-driven earth-observation data-access

Last synced: about 21 hours ago
JSON representation

Repository metadata

Python Library for NASA Earthdata APIs

README.md

earthaccess

earthaccess is a python library to search for, and download or stream NASA Earth science data with just a few lines of code.

Visit our documentation to learn more!

Try it in your browser without installing anything! Binder

Why earthaccess

During several workshops organized by NASA Openscapes, the need to provide easy-to-use tools to our users became evident. Open science is a collaborative effort; it involves people from different technical backgrounds, and the data analysis to solve the pressing problems we face cannot be limited by the complexity of the underlying systems. Therefore, providing easy access to NASA Earthdata regardless of the data storage location (hosted within or outside of the cloud) is the main motivation behind this Python library.

How to Get Started with earthaccess

How to install

To install earthaccess go to your terminal and install it using pip:

python -m pip install earthaccess

How to access NASA Earth Science data

With earthaccess, data is 3 steps away!

import earthaccess

# 1. Login
earthaccess.login()

# 2. Search
results = earthaccess.search_data(
    short_name='ATL06',  # ATLAS/ICESat-2 L3A Land Ice Height
    bounding_box=(-10, 20, 10, 50),  # Only include files in area of interest...
    temporal=("1999-02", "2019-03"),  # ...and time period of interest.
    count=10
)

# 3. Access
files = earthaccess.download(results, "/tmp/my-download-folder")

Visit our quick start guide for more details.

Help!

We're here for you!
Before you open a new issue/discussion/topic, please search to see if anyone else has
opened a similar one.

🐛 If you've found a bug or mistake, please use
GitHub issues.

💡 If you'd like to request a feature or ask a question, please use
GitHub discussions.

🗨️ If you prefer real-time chat, please visit us in our
Zulip chat space!
We'd love to see you there! 👐

Compatibility

The minimum supported Python version is 3.12.

How to Contribute to earthaccess

If you want to contribute to earthaccess checkout the Contributing Guide.

Contributors

Contributors

Citation (CITATION.cff)

cff-version: 1.2.0
message: |
  Please cite this software using these metadata.
  Authors are listed in alphabetical order.

title: "earthaccess"
doi: "10.5281/zenodo.8365009"
abstract: "Python Library for NASA Earthdata APIs"
contact:
  - name: "The earthaccess community"
    website: "https://github.com/earthaccess-dev/earthaccess/discussions"
  - name: "NSIDC"
    email: "nsidc@nsidc.org"
type: "software"
# NOTE: The CFF spec says `license` can be a list, but Zenodo is currently not
#       accepting lists for this key:
#       https://github.com/zenodo/zenodo/issues/2515
license: "MIT"
keywords:
  - "data"
  - "Remote sensing"
  - "Cloud computing"
  - "authentication"
  - "Earthdata Login"

url: "https://earthaccess.readthedocs.io"
repository-code: "https://github.com/earthaccess-dev/earthaccess"

version: "0.18.0"
date-released: "2026-05-12"

authors:
  - family-names: "Barrett"
    given-names: "Andrew"
    orcid: "https://orcid.org/0000-0003-4394-5445"
    website: "https://github.com/andypbarrett"
  - family-names: "Battisto"
    given-names: "Chris"
    orcid: "https://orcid.org/0000-0002-9608-3634"
    website: "https://github.com/battistowx"
  - family-names: "Bourbeau"
    given-names: "James"
    orcid: "https://orcid.org/0000-0003-2164-7789"
    website: "https://github.com/jrbourbeau"
  - family-names: "Carroll"
    given-names: "Ian"
    orcid: "https://orcid.org/0000-0002-3616-810X"
    website: "https://github.com/itcarroll"
  - family-names: "Daniels"
    given-names: "Chuck"
    website: "https://github.com/chuckwondo"
  - family-names: "Fisher"
    given-names: "Matt"
    orcid: "https://orcid.org/0000-0003-3260-5445"
    website: "https://mfisher87.github.io/"
  - family-names: "Kaufman"
    given-names: "Daniel"
    orcid: "https://orcid.org/0000-0002-1487-7298"
    website: "https://github.com/danielfromearth"
  - family-names: "Kennedy"
    given-names: "Joseph"
    orcid: "https://orcid.org/0000-0002-9348-693X"
    website: "https://github.com/jhkennedy"
  - family-names: "Lopez"
    given-names: "Luis"
    orcid: "https://orcid.org/0000-0003-4896-3263"
    website: "https://github.com/betolink"
  - family-names: "Lowndes"
    given-names: "Julia"
    orcid: "https://orcid.org/0000-0003-1682-3872"
    website: "https://github.com/jules32"
  - family-names: "Scheick"
    given-names: "Jessica"
    orcid: "https://orcid.org/0000-0002-3421-4459"
    website: "https://github.com/JessicaS11"
  - family-names: "Steiker"
    given-names: "Amy"
    orcid: "https://orcid.org/0000-0002-3039-0260"
    website: "https://github.com/asteiker"
  - family-names: "Varghese"
    given-names: "Sherwin"
    orcid: "https://orcid.org/0009-0005-7030-213X"
    website: "https://github.com/Sherwin-14"



references:
  - type: "grant"
    title: "Openscapes: Supporting better science for future us"
    institution:
      name: "National Aeronautics and Space Administration"
    number: "20-TWSC20-2-0003"
    authors:
      - family-names: "Lowndes"
        given-names: "Julia"
        orcid: "https://orcid.org/0000-0003-1682-3872"
        website: "https://github.com/jules32"
      - family-names: "Robinson"
        given-names: "Erin"
        orcid: "https://orcid.org/0000-0001-9998-0114"
        website: "https://erinrobinson.info/"

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 1,365
Total Committers: 61
Avg Commits per committer: 22.377
Development Distribution Score (DDS): 0.775

Commits in past year: 387
Committers in past year: 28
Avg Commits per committer in past year: 13.821
Development Distribution Score (DDS) in past year: 0.773

Name Email Commits
betolink b****n@g****m 307
Matt Fisher m****7@g****m 206
Sherwin Varghese 1****4 104
Andy Barrett a****t@n****g 97
Joseph H Kennedy me@j****g 67
danielfromearth d****n@n****v 63
Chuck Daniels c****k@d****g 55
James Bourbeau j****u@g****m 51
Ian Carroll i****l@n****v 39
dependabot[bot] 4****] 34
pre-commit-ci[bot] 6****] 31
betolink:w l****z@n****g 30
doug-newman-nasa d****n@n****v 25
jennifer j****k@c****u 24
Andy Barrett a****t@g****m 21
ayushnag 3****g 17
Matt Fisher m****r@n****g 14
Benjamin Root b****t@g****m 13
Julia Stewart Lowndes j****a@o****g 13
ana-sher n****a@g****m 12
karthik venkataramani k****t@v****u 10
Chris Battisto 3****x 10
Hailiang Zhang h****g@n****v 9
Amy Steiker 4****r 8
Owen Littlejohns o****s@n****v 8
Keenan Ganz 3****z 8
Kevin Grimes K****s@j****v 7
Trey Stafford t****d@c****u 6
Doug Newman d****n@n****v 6
asteiker a****r@g****m 6
and 31 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 73
Total pull requests: 87
Average time to close issues: 2 months
Average time to close pull requests: 11 days
Total issue authors: 26
Total pull request authors: 23
Average comments per issue: 2.71
Average comments per pull request: 2.66
Merged pull request: 56
Bot issues: 3
Bot pull requests: 12

Past year issues: 73
Past year pull requests: 86
Past year average time to close issues: 2 months
Past year average time to close pull requests: 7 days
Past year issue authors: 26
Past year pull request authors: 22
Past year average comments per issue: 2.71
Past year average comments per pull request: 2.56
Past year merged pull request: 55
Past year bot issues: 3
Past year bot pull requests: 12

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/earthaccess-dev/earthaccess

Top Issue Authors

  • mfisher87 (20)
  • andypbarrett (11)
  • saberbrasher (6)
  • asteiker (5)
  • Sherwin-14 (4)
  • github-actions[bot] (3)
  • itcarroll (2)
  • chuckwondo (2)
  • jhkennedy (2)
  • danielfromearth (2)
  • stefaniebutland (1)
  • ameliaholcomb (1)
  • jackiryan (1)
  • GWModels (1)
  • mccabete (1)

Top Pull Request Authors

  • Sherwin-14 (27)
  • dependabot[bot] (11)
  • mfisher87 (7)
  • danielfromearth (4)
  • mvanhorn (4)
  • saberbrasher (4)
  • andypbarrett (4)
  • chuckwondo (4)
  • tmchow (3)
  • betolink (3)
  • Copilot (2)
  • asteiker (2)
  • jhkennedy (2)
  • stefaniebutland (1)
  • tomaioo (1)

Top Issue Labels

  • impact: documentation (23)
  • type: bug (16)
  • type: enhancement (9)
  • impact: automation (9)
  • type: experience report (9)
  • needs: decision (7)
  • needs: triage (7)
  • impact: breaking (4)
  • good first issue (3)
  • metrics (2)
  • needs: feedback requested (1)
  • github_actions (1)
  • impact: governance (1)
  • impact: blocks release (1)
  • needs: help (1)

Top Pull Request Labels

  • dependencies (11)
  • impact: documentation (7)
  • github_actions (7)
  • python:uv (4)
  • type: bug (1)
  • impact: LLM (1)
  • impact: automation (1)
  • impact: governance (1)

Package metadata

pypi.org: earthaccess

Client library for NASA Earthdata APIs

  • Homepage:
  • Documentation: https://earthaccess.readthedocs.io
  • Licenses: MIT
  • Latest release: 0.18.0 (published 3 months ago)
  • Last Synced: 2026-08-12T01:01:16.174Z (2 days ago)
  • Versions: 24
  • Dependent Packages: 8
  • Dependent Repositories: 7
  • Downloads: 247,719 Last month
  • Docker Downloads: 155
  • Rankings:
    • Docker downloads count: 2.317%
    • Dependent packages count: 2.377%
    • Stargazers count: 4.196%
    • Average: 4.412%
    • Dependent repos count: 5.533%
    • Downloads: 5.775%
    • Forks count: 6.275%
  • Maintainers (1)

Dependencies

pyproject.toml pypi
  • autoflake >=1.3 develop
  • black >=21.11b0 develop
  • flake8 >=3.7 develop
  • ipywidgets ^7.7.0 develop
  • isort >=5 develop
  • jupyterlab >=3 develop
  • markdown-include >=0.6 develop
  • mkdocs >=1.2 develop
  • mkdocs-jupyter =0.19.0 develop
  • mkdocs-material >=7.1,<9.0 develop
  • mkdocstrings >=0.18 develop
  • mypy >=0.812 develop
  • pre-commit >=2.4 develop
  • pygments =2.11.1 develop
  • pymdown-extensions =9.2 develop
  • pytest >=6.0 develop
  • pytest-cov >=2.8 develop
  • pytest-watch >=4.2 develop
  • responses >=0.14 develop
  • types-requests >=0.1 develop
  • types-setuptools >=0.1 develop
  • widgetsnbextension ^3.6.0 develop
  • pqdm >=0.1
  • python >=3.8,<4.0
  • python-benedict >=0.25
  • python-cmr >=0.7
  • requests >=2.26
  • s3fs >=2021.11, <2024
  • tinynetrc ^1.3.1
.github/workflows/issue-manager.yml actions
  • tiangolo/issue-manager master composite
.github/workflows/publish.yml actions
  • JRubics/poetry-publish v1.8 composite
  • actions/checkout v2 composite
.github/workflows/test.yml actions
  • actions/cache v1 composite
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
  • codecov/codecov-action v1 composite
.github/workflows/integration-test.yml actions
  • actions/cache v1 composite
  • actions/checkout v2 composite
  • actions/setup-python v1 composite
  • codecov/codecov-action v1 composite
.github/workflows/pr-rtd-link.yml actions
  • readthedocs/actions/preview v1 composite
.github/workflows/test-mindeps.yml actions
  • actions/checkout v4.1.1 composite
  • codecov/codecov-action v1 composite
  • conda-incubator/setup-miniconda v2.2.0 composite
.github/workflows/binder-badge.yml actions
  • manics/action-binderbadge 99560b89939071823821e105afc83aaa87927e03 composite
.github/workflows/issue-metrics.yml actions
  • github-community-projects/issue-metrics df8c49d20958f9345281fa2124858bd0ad227e1f composite
  • peter-evans/create-issue-from-file fca9117c27cdc29c6c4db3b86c48e4115a786710 composite
.github/actions/install-pkg/action.yml actions
  • actions/setup-python ece7cb06caefa5fff74198d8649806c4678c61a1 composite
  • astral-sh/setup-uv 11f9893b081a58869d3b5fccaea48c9e9e46f990 composite
.github/workflows/discussions.yml actions
.binder/environment.yml conda
  • pip >=25.1
  • python 3.12
.github/workflows/integration-test-review.yml actions
  • actions-cool/check-user-permission c21884f3dda18dafc2f8b402fe807ccc9ec1aa5e composite
  • actions/github-script 3a2844b7e9c422d3c10d287c895573f7108da1b3 composite
.github/workflows/zizmor.yml actions
  • actions/checkout 3d3c42e5aac5ba805825da76410c181273ba90b1 composite
  • zizmorcore/zizmor-action 6599ee8b7a49aef6a770f63d261d214911a7ce02 composite
.github/workflows/check-links.yml actions
  • actions/checkout 3d3c42e5aac5ba805825da76410c181273ba90b1 composite
  • jupyterlab/maintainer-tools/.github/actions/base-setup b48fcdb87e70c45789abd80d4042b06641e47b46 composite
  • jupyterlab/maintainer-tools/.github/actions/check-links b48fcdb87e70c45789abd80d4042b06641e47b46 composite
environment.yml conda
  • pip
  • python 3.13
uv.lock pypi
  • 245 dependencies

Score: 23.209964425253155