{"id":13482274,"url":"https://github.com/sentinel-hub/sentinelhub-py","last_synced_at":"2025-05-13T23:09:36.016Z","repository":{"id":21010520,"uuid":"91571506","full_name":"sentinel-hub/sentinelhub-py","owner":"sentinel-hub","description":"Download and process satellite imagery in Python using Sentinel Hub services.","archived":false,"fork":false,"pushed_at":"2025-03-10T11:46:03.000Z","size":230957,"stargazers_count":847,"open_issues_count":18,"forks_count":251,"subscribers_count":50,"default_branch":"master","last_synced_at":"2025-05-09T21:14:40.019Z","etag":null,"topics":["aws","ogc-services","python-library","satellite-imagery","sentinel-hub"],"latest_commit_sha":null,"homepage":"http://sentinelhub-py.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sentinel-hub.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.MD","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"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":"2017-05-17T12:00:34.000Z","updated_at":"2025-05-06T20:47:01.000Z","dependencies_parsed_at":"2023-09-21T19:29:53.600Z","dependency_job_id":"5940e29f-82c9-4355-862c-a69f27cc248d","html_url":"https://github.com/sentinel-hub/sentinelhub-py","commit_stats":{"total_commits":1235,"total_committers":46,"mean_commits":"26.847826086956523","dds":"0.37732793522267205","last_synced_commit":"4f4fd88d6613f6c21278f644cf1ed78b388bbaea"},"previous_names":[],"tags_count":67,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentinel-hub%2Fsentinelhub-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentinel-hub%2Fsentinelhub-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentinel-hub%2Fsentinelhub-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sentinel-hub%2Fsentinelhub-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sentinel-hub","download_url":"https://codeload.github.com/sentinel-hub/sentinelhub-py/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253384819,"owners_count":21899930,"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":["aws","ogc-services","python-library","satellite-imagery","sentinel-hub"],"created_at":"2024-07-31T17:01:00.493Z","updated_at":"2025-05-13T23:09:35.947Z","avatar_url":"https://github.com/sentinel-hub.png","language":"Python","funding_links":[],"categories":["Tools","`Python` processing of optical imagery (non deep learning)","Python","Sustainable Development","Geospatial and Earth Observation"],"sub_categories":["Search \u0026 Download","Company specific examples","Environmental Satellites"],"readme":"[![Package version](https://badge.fury.io/py/sentinelhub.svg)](https://pypi.org/project/sentinelhub/)\n[![Conda version](https://img.shields.io/conda/vn/conda-forge/sentinelhub.svg)](https://anaconda.org/conda-forge/sentinelhub)\n[![Supported Python versions](https://img.shields.io/pypi/pyversions/sentinelhub.svg?style=flat-square)](https://pypi.org/project/sentinelhub/)\n[![Build Status](https://github.com/sentinel-hub/sentinelhub-py/actions/workflows/ci_action.yml/badge.svg?branch=master)](https://github.com/sentinel-hub/sentinelhub-py/actions)\n[![Docs status](https://readthedocs.org/projects/sentinelhub-py/badge/?version=latest)](https://sentinelhub-py.readthedocs.io/en/latest/)\n[![Overall downloads](https://pepy.tech/badge/sentinelhub)](https://pepy.tech/project/sentinelhub)\n[![Last month downloads](https://pepy.tech/badge/sentinelhub/month)](https://pepy.tech/project/sentinelhub)\n[![](https://img.shields.io/pypi/l/sentinelhub.svg)](https://github.com/sentinel-hub/sentinelhub-py/blob/master/LICENSE.md)\n[![Code coverage](https://codecov.io/gh/sentinel-hub/sentinelhub-py/branch/master/graph/badge.svg)](https://codecov.io/gh/sentinel-hub/sentinelhub-py)\n\n## Introduction\n\nThe **sentinelhub** Python package is the official Python interface for [Sentinel Hub services](https://www.sentinel-hub.com/). It supports most of the services described in the [Sentinel Hub documentation](https://docs.sentinel-hub.com/api/latest/) and any type of [satellite data collections](https://docs.sentinel-hub.com/api/latest/data/), including Sentinel, Landsat, MODIS, DEM, and custom collections produced by users.\n\nThe package also provides a collection of basic tools and utilities for working with geospatial and satellite data. It builds on top of well known packages such as `numpy`, `shapely`, `pyproj`, etc. It is also a core dependency of [`eo-learn`](https://github.com/sentinel-hub/eo-learn) Python package for creating geospatial data-processing workflows.\n\nThe main package resources are [GitHub repository](https://github.com/sentinel-hub/sentinelhub-py), [documentation page](https://sentinelhub-py.readthedocs.io/en/latest/), and [Sentinel Hub forum](https://forum.sentinel-hub.com/).\n\n\n## Installation\n\nThe package requires a Python version \u003e= 3.8. The package is available at the PyPI package index and can be installed with\n\n```\n$ pip install sentinelhub\n```\n\nor with an extension tag for additional functionalities\n\n```\n$ pip install sentinelhub[AWS]  # extra dependencies for interacting with Amazon Web Services\n```\n\nAlternatively, the package can be installed with Conda from `conda-forge` channel\n\n```\n$ conda install -c conda-forge sentinelhub\n```\n\nTo install the package manually, clone the repository and run\n\n```\n$ pip install .\n```\n\nBefore installing `sentinelhub` on **Windows** it is recommended to install `shapely` package from\n[Unofficial Windows wheels repository](https://www.lfd.uci.edu/~gohlke/pythonlibs/)\n\nOnce installed the package can be configured according to [configuration instructions](https://sentinelhub-py.readthedocs.io/en/latest/configure.html) in documentation.\n\n\n## Content\n\nA high-level overview of the main functionalities:\n\n- Sentinel Hub services\n  * [Process API](https://docs.sentinel-hub.com/api/latest/api/process/),\n  * [Catalog API](https://docs.sentinel-hub.com/api/latest/api/catalog/),\n  * [Batch Processing API](https://docs.sentinel-hub.com/api/latest/api/batch/),\n  * [BYOC API](https://docs.sentinel-hub.com/api/latest/api/byoc/),\n  * [Statistical API](https://docs.sentinel-hub.com/api/latest/api/statistical/),\n  * [OGC services (WMS/WCS/WFS)](https://docs.sentinel-hub.com/api/latest/api/ogc/),\n  * [FIS](https://www.sentinel-hub.com/develop/api/ogc/fis-request/),\n  * authentication and rate-limit handling,\n\n- geospatial utilities\n  * interface for geospatial objects and transformations,\n  * large area splitting,\n  * data collection objects,\n  * IO tools,\n\n- [Geopedia](https://portal.geopedia.world/) WMS and REST API.\n\n\n## Documentation\n\nFor more information on the package and to access the documentation, visit [readthedocs](https://sentinelhub-py.readthedocs.io/).\n\n\n## Examples\n\nThe package has a collection of Jupyter notebooks with examples. They are available in the [examples folder](https://github.com/sentinel-hub/sentinelhub-py/tree/master/examples) on GitHub and converted into documentation under [Examples section](https://sentinelhub-py.readthedocs.io/en/latest/examples.html).\n\nAdditionally, some examples are explained in Sentinel Hub webinar videos:\n\n- [Process API in Python](https://www.youtube.com/watch?v=sX3w3Wd3FBw\u0026list=PL46vEE2ks3tn8NGesSFllgJW5MSYRi4od\u0026index=10\u0026t=2220s)\n- [OGC API in Python](https://www.youtube.com/watch?v=CBIlTOl2po4\u0026list=PL46vEE2ks3tn8NGesSFllgJW5MSYRi4od\u0026index=4\u0026t=1766s)\n\n\n## Blog posts\n\nThe package played a key role in many projects and use cases described at [Sentinel Hub blog](https://medium.com/sentinel-hub). The following blog posts are about the package itself:\n\n * [Upgrading the sentinelhub Python package](https://medium.com/sentinel-hub/upgrading-the-sentinelhub-python-package-2665f9c10df)\n * [Release of sentinelhub Python Package 2.0](https://medium.com/sentinel-hub/release-of-sentinelhub-python-package-2-0-a3d47709f8fd)\n\n\n## Questions and Issues\n\nFeel free to ask questions about the package and its use cases at [Sentinel Hub forum](https://forum.sentinel-hub.com/) or raise an issue on [GitHub](https://github.com/sentinel-hub/sentinelhub-py/issues).\n\nYou are welcome to send your feedback to the package authors, Sentinel Hub research team, through any of [Sentinel Hub communication channels](https://sentinel-hub.com/develop/communication-channels).\n\n\n## License\n\nSee [LICENSE](https://github.com/sentinel-hub/sentinelhub-py/blob/master/LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsentinel-hub%2Fsentinelhub-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsentinel-hub%2Fsentinelhub-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsentinel-hub%2Fsentinelhub-py/lists"}