{"id":25723522,"url":"https://github.com/cs-si/eodag","last_synced_at":"2026-04-01T17:32:42.221Z","repository":{"id":37406135,"uuid":"203819248","full_name":"CS-SI/eodag","owner":"CS-SI","description":"Earth Observation Data Access Gateway","archived":false,"fork":false,"pushed_at":"2024-10-29T08:24:44.000Z","size":52547,"stargazers_count":322,"open_issues_count":116,"forks_count":44,"subscribers_count":12,"default_branch":"develop","last_synced_at":"2024-10-29T09:39:35.660Z","etag":null,"topics":["catalog","cbers","copernicus","downloader","earth-observation","eodag","geographic-data","geospatial","gis","landsat","modis","remote-sensing","satellite-imagery","search","sentinel","spatial-imagery","stac"],"latest_commit_sha":null,"homepage":"https://eodag.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CS-SI.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-22T15:08:57.000Z","updated_at":"2024-10-29T08:19:38.000Z","dependencies_parsed_at":"2023-12-01T08:31:28.563Z","dependency_job_id":"264b4fff-70d8-4361-9be5-b999ea84cee7","html_url":"https://github.com/CS-SI/eodag","commit_stats":{"total_commits":1324,"total_committers":31,"mean_commits":42.70967741935484,"dds":0.5324773413897281,"last_synced_commit":"441cefac33c8d93ee4ae8d596732fe24618faaf8"},"previous_names":[],"tags_count":79,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CS-SI%2Feodag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CS-SI","download_url":"https://codeload.github.com/CS-SI/eodag/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245547860,"owners_count":20633456,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["catalog","cbers","copernicus","downloader","earth-observation","eodag","geographic-data","geospatial","gis","landsat","modis","remote-sensing","satellite-imagery","search","sentinel","spatial-imagery","stac"],"created_at":"2025-02-25T20:36:58.522Z","updated_at":"2026-04-01T17:32:42.214Z","avatar_url":"https://github.com/CS-SI.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://eodag.readthedocs.io/en/latest/_static/eodag_bycs.png\n    :target: https://github.com/CS-SI/eodag\n\n|\n\n.. |pypi-badge| image:: https://badge.fury.io/py/eodag.svg\n    :target: https://badge.fury.io/py/eodag\n\n.. |conda-badge| image:: https://img.shields.io/conda/vn/conda-forge/eodag\n    :target: https://anaconda.org/conda-forge/eodag\n\n.. |rtd-badge| image:: https://readthedocs.org/projects/eodag/badge/?version=latest\u0026style=flat\n    :target: https://eodag.readthedocs.io/en/latest/\n\n.. |gha-badge| image:: https://github.com/CS-SI/eodag/actions/workflows/test.yml/badge.svg\n    :target: https://github.com/CS-SI/eodag/actions\n\n.. |ghi-badge| image:: https://img.shields.io/github/issues/CS-SI/eodag.svg\n    :target: https://github.com/CS-SI/eodag/issues\n\n.. |binder-badge| image:: https://mybinder.org/badge_logo.svg\n    :target: https://mybinder.org/v2/git/https%3A%2F%2Fgithub.com%2FCS-SI%2Feodag.git/master?filepath=docs%2Fnotebooks%2Fintro_notebooks.ipynb\n\n|pypi-badge| |conda-badge| |rtd-badge| |gha-badge| |ghi-badge| |binder-badge|\n\n.. |license-badge| image:: https://img.shields.io/pypi/l/eodag.svg\n    :target: https://pypi.org/project/eodag/\n\n.. |versions-badge| image:: https://img.shields.io/pypi/pyversions/eodag.svg\n    :target: https://pypi.org/project/eodag/\n\n.. |zenodo-badge| image:: https://zenodo.org/badge/203819248.svg\n  :target: https://doi.org/10.5281/zenodo.18552649\n\n|license-badge| |versions-badge| |zenodo-badge|\n\n|\n\n..\n\n    Checkout **EODAG Jupyterlab extension**: `eodag-labextension \u003chttps://github.com/CS-SI/eodag-labextension\u003e`_!\n    This will bring a friendly UI to your notebook and help you search and browse for EO products using ``eodag``.\n\nEODAG (Earth Observation Data Access Gateway) is a command line tool and a plugin-oriented Python framework for searching,\naggregating results and downloading remote sensed images while offering a unified API for data access regardless of the\ndata provider. The EODAG SDK is structured around three functions:\n\n* List collections: list of supported products and their description\n\n* Search products (by collection or uid): searches products according to the search criteria provided\n\n* Download products: download product “as is\"\n\nEODAG is developed in Python. It is structured according to a modular plugin architecture, easily extensible and able to\nintegrate new data providers. Three types of plugins compose the tool:\n\n* Catalog search plugins, responsible for searching data (STAC, OpenSearch, OData, ...), building paths, retrieving quicklook,\n  combining results\n\n* Download plugins, allowing to download and retrieve data locally (via HTTP, S3, ...), always with the same directory\n  organization\n\n* Authentication plugins, which are used to authenticate the user on the external services used (JSON Token, Basic Auth, OIDC, ...).\n\nRead `the documentation \u003chttps://eodag.readthedocs.io/en/latest/\u003e`_ for more insights.\n\n.. image:: https://raw.githubusercontent.com/CS-SI/eodag/develop/docs/_static/eodag_overview.png\n   :alt: EODAG overview\n   :class: no-scaled-link\n\nInstallation\n============\n\nEODAG is available on `PyPI \u003chttps://pypi.org/project/eodag/\u003e`_:\n\n.. code-block:: bash\n\n   python -m pip install eodag\n\nAnd with ``conda`` from the `conda-forge channel \u003chttps://anaconda.org/conda-forge/eodag\u003e`_:\n\n.. code-block:: bash\n\n   conda install -c conda-forge eodag\n\n..\n\n  [!IMPORTANT]\n\n  `Breaking change \u003chttps://eodag.readthedocs.io/en/latest/breaking_changes.html\u003e`_ **in v3.0.0**:\n  Please note that EODAG\n  comes with a minimal set of dependencies. If you want more features, please install using one of the\n  `available extras \u003chttps://eodag.readthedocs.io/en/latest/getting_started_guide/install.html#optional-dependencies\u003e`_.\n\nUsage\n=====\n\nFor downloading you will need to fill your credentials for the desired providers in your\n`eodag user configuration file \u003chttps://eodag.readthedocs.io/en/latest/getting_started_guide/configure.html\u003e`_.\nThe file will automatically be created with empty values on the first run.\n\nPython API\n----------\n\nExample usage for interacting with the api in your Python code:\n\n.. code-block:: python\n\n    from eodag import EODataAccessGateway\n\n    dag = EODataAccessGateway()\n\n    search_results = dag.search(\n        collection='S2_MSI_L1C',\n        geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 44}, # accepts WKT polygons, shapely.geometry, ...\n        start='2021-01-01',\n        end='2021-01-15'\n    )\n\n    product_paths = dag.download_all(search_results)\n\n\nThis will search for Sentinel 2 level-1C products on the default provider and return the found products first page and\nan estimated total number of products matching the search criteria. And then it will download these products. Please\ncheck the `Python API User Guide \u003chttps://eodag.readthedocs.io/en/latest/api_user_guide.html\u003e`_ for more details.\n\n..\n\n  [!IMPORTANT]\n\n  `Breaking change \u003chttps://eodag.readthedocs.io/en/latest/breaking_changes.html\u003e`_ **in v3.0.0**:\n  `search() \u003chttps://eodag.readthedocs.io/en/latest/api_reference/core.html#eodag.api.core.EODataAccessGateway.search\u003e`_ method now returns\n  only a single ``SearchResult`` instead of a 2 values tuple.\n\n\nCommand line interface\n----------------------\n\nStart playing with the CLI:\n\n- To search for some products::\n\n     eodag search --collection S2_MSI_L1C --box 1 43 2 44 --start 2021-03-01 --end 2021-03-31\n\n  The request above searches for ``S2_MSI_L1C`` collections in a given bounding box, in March 2021. It saves the results in a GeoJSON file (``search_results.geojson`` by default).\n\n  Results are paginated, you may want to get all pages at once with ``--all``, or search products having 20% of maximum coud cover with ``--cloudCover 20``. For more information on available options::\n\n     eodag search --help\n\n- To download the result of the previous call to search::\n\n     eodag download --search-results search_results.geojson\n\n- To download only the result quicklooks of the previous call to search::\n\n     eodag download --quicklooks --search-results search_results.geojson\n\n- To list all available collections and supported providers::\n\n     eodag list\n\n- To list available collections on a specified supported provider::\n\n     eodag list -p creodias\n\n- To see all the available options and commands::\n\n     eodag --help\n\n- To print log messages, add ``-v`` to eodag master command. e.g. ``eodag -v list``. The more ``v`` given (up to 3), the more verbose the tool is. For a full verbose output, do for example: ``eodag -vvv list``\n\nContribute\n==========\n\nHave you spotted a typo in our documentation? Have you observed a bug while running EODAG?\nDo you have a suggestion for a new feature?\n\nDon't hesitate and open an issue or submit a pull request, contributions are most welcome!\n\nFor guidance on setting up a development environment and how to make a\ncontribution to eodag, see the `contributing guidelines`_.\n\n.. _contributing guidelines: https://github.com/CS-SI/eodag/blob/develop/CONTRIBUTING.rst\n\n\nLicense\n=======\n\nEODAG is licensed under Apache License v2.0.\nSee LICENSE file for details.\n\n\nAuthors\n=======\n\nEODAG has been created by `CS GROUP - France \u003chttps://www.csgroup.eu/\u003e`_.\n\n\nCredits\n=======\n\nEODAG is built on top of amazingly useful open source projects. See NOTICE file for details about those projects and\ntheir licenses.\nThank you to all the authors of these projects!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcs-si%2Feodag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcs-si%2Feodag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcs-si%2Feodag/lists"}