{"id":28956743,"url":"https://github.com/developmentseed/eoapi","last_synced_at":"2025-06-23T21:40:38.496Z","repository":{"id":38215526,"uuid":"395122066","full_name":"developmentseed/eoAPI","owner":"developmentseed","description":"[Active Development] Earth Observation API (Metadata, Raster and Vector services)","archived":false,"fork":false,"pushed_at":"2025-05-02T17:13:24.000Z","size":9273,"stargazers_count":255,"open_issues_count":18,"forks_count":26,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-06-19T06:49:50.335Z","etag":null,"topics":["eoapi"],"latest_commit_sha":null,"homepage":"https://eoapi.dev","language":"Shell","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/developmentseed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2021-08-11T21:36:09.000Z","updated_at":"2025-06-14T18:52:11.000Z","dependencies_parsed_at":"2023-10-14T15:34:35.977Z","dependency_job_id":"c1075cfd-945e-4ac7-b35a-0a5e6f24b2af","html_url":"https://github.com/developmentseed/eoAPI","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/developmentseed/eoAPI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FeoAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FeoAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FeoAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FeoAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/developmentseed","download_url":"https://codeload.github.com/developmentseed/eoAPI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developmentseed%2FeoAPI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261561177,"owners_count":23177543,"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":["eoapi"],"created_at":"2025-06-23T21:40:37.741Z","updated_at":"2025-06-23T21:40:38.474Z","avatar_url":"https://github.com/developmentseed.png","language":"Shell","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"700\" src=\"docs/logos/eoAPI.png\"/\u003e\n  \u003cp align=\"center\"\u003eCreate a full Earth Observation API with Metadata, Raster, and Vector services.\u003c/p\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/developmentseed/eoAPI/blob/main/LICENSE\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/developmentseed/titiler.svg\" alt=\"Downloads\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n**Documentation**: \u003ca href=\"https://eoapi.dev\" target=\"_blank\"\u003ehttps://eoapi.dev\u003c/a\u003e\n\n**Source Code**: \u003ca href=\"https://github.com/developmentseed/eoAPI\" target=\"_blank\"\u003ehttps://github.com/developmentseed/eoAPI\u003c/a\u003e\n\n\u003e [!IMPORTANT] \n\u003e **We would :heart: to hear from you!**\n\u003e Please [join the discussion](https://github.com/developmentseed/eoAPI/discussions/209) and let us know how you're using eoAPI! This helps us improve the project for you and others.\n\u003e If you prefer to remain anonymous, you can email us at [eoapi@developmentseed.org](mailto:eoapi@developmentseed.org), and we’ll be happy to post a summary on your behalf.\n\n---\n\n## **E**arth **O**bservation **API**\n\n`eoAPI` combines several *state-of-the-art* projects to create a full Earth Observation API. Each service can be used and deployed independently, but `eoAPI` creates the interconnections between each service:\n\n- **pgSTAC** database [https://github.com/stac-utils/pgstac](https://github.com/stac-utils/pgstac)\n\n- **STAC API** built on top of [https://github.com/stac-utils/stac-fastapi](https://github.com/stac-utils/stac-fastapi)\n\n- **STAC Items And Mosaic Raster Tiles** API built on top of [https://github.com/stac-utils/titiler-pgstac](https://github.com/stac-utils/titiler-pgstac)\n\n- **OGC Features and Vector Tiles** API built on top of [https://github.com/developmentseed/tipg](https://github.com/developmentseed/tipg)\n\n- **A STAC Catalog browsing UI** based on the radiant earth browser : [https://github.com/radiantearth/stac-browser](https://github.com/radiantearth/stac-browser)\n\n---\n\n## 🌍 eoAPI: An Open-Source Community Project\n\n`eoAPI` is proudly open-source and driven by a dedicated community of contributors. We believe in the power of open collaboration and welcome anyone to contribute, discuss, and grow this tool. Join the conversations on [GitHub Discussions](https://github.com/developmentseed/eoAPI/discussions) and make a difference in the Earth Observation realm.\n\n\n---\n\n## Getting started\n\nThe easiest way to start exploring the different eoAPI services is with *Docker*. Clone this repository and start the multi-container *Docker* applications using `Compose`:\n\n```\ngit clone https://github.com/developmentseed/eoAPI.git\ncd eoAPI\ndocker compose up\n```\n\nOnce the applications are *up*, you'll need to add STAC **Collections** and **Items** to the PgSTAC database. If you don't have these available, you can follow the [MAXAR open data demo](https://github.com/vincentsarago/MAXAR_opendata_to_pgstac) (or get inspired by the other [demos](https://github.com/developmentseed/eoAPI/tree/main/demo)).\n\nThen you can start exploring your dataset with:\n\n  - the STAC Metadata service [http://localhost:8081](http://localhost:8081)\n  - the Raster service [http://localhost:8082](http://localhost:8082)\n  - the browser UI [http://localhost:8085](http://localhost:8085)\n\nIf you've added a vector dataset to the `public` schema in the Postgres database, they will be available through the **Vector** service at [http://localhost:8083](http://localhost:8083).\n\n### Local deployment\n\nThe services can be deployed altogether locally with `docker compose up`.\n\nAlternatively, you may install the libraries and launch the applications manually:\n\n\u003cdetails\u003e\n\n```bash\npython -m pip install --upgrade virtualenv\nvirtualenv .venv\nsource .venv/bin/activate\n\nexport DATABASE_URL=postgresql://username:password@0.0.0.0:5439/postgis  # Connect to the database of your choice\n\npython -m pip install uvicorn\n\n###############################################################################\n# Install and launch the application\n# Select one of the following\n\n###############################################################################\n# STAC\npython -m pip install \"psycopg[binary,pool]\" stac-fastapi-pgstac\npython -m uvicorn stac_fastapi.pgstac.app:app --port 8081 --reload\n\n###############################################################################\n# RASTER\npython -m pip install \"psycopg[binary,pool]\" titiler-pgstac\npython -m uvicorn titiler.pgstac.main:app --port 8082 --reload\n\n###############################################################################\n# VECTOR\npython -m pip install tipg\npython -m uvicorn tipg.main:app --port 8083 --reload\n```\n\nNote: Python libraries might have incompatible dependencies, which you can resolve by using a virtual environment for each one.\n\n\u003c/details\u003e\n\n### Deployment on the cloud\n\n#### Kubernetes\n\n[eoapi-k8s](https://github.com/developmentseed/eoapi-k8s) contains IaC and Helm charts for deploying eoAPI services on AWS and GCP.\n\n#### AWS CDK\n\n[eoapi-cdk](https://github.com/developmentseed/eoapi-cdk) defines a set of AWS CDK constructs that can be used to deploy eoAPI services on AWS. An official example usage of these constructs can be found at [eoapi-template](https://github.com/developmentseed/eoapi-template).\n\n\n## Deployment with custom runtimes\n\nAn example of custom eoAPI runtimes and deployment can be found at [eoapi-devseed](https://github.com/developmentseed/eoapi-devseed).\n\n## Contribution \u0026 Development\n\nWe highly value and rely on our community! You can make a difference whether you're an expert or just getting started. Here's how:\n\n- **Engage in Discussions**: Share your ideas, ask questions, or provide feedback through [GitHub Discussions](https://github.com/developmentseed/eoAPI/discussions). This is where most of our project conversations take place.\n- **Report Issues**: Found a bug or have a feature request? Raise it on our [issues page](https://github.com/developmentseed/eoAPI/issues).\n\n---\n## License\n\nAt Development Seed, we believe in open collaboration and making tools and data more accessible. In line with this ethos, we've explicitly chosen a MIT license for `eoAPI`.\n\nFor full license details, see [LICENSE](https://github.com/developmentseed/eoAPI/blob/main/LICENSE).\n\n## Authors\n\nNurtured by [Development Seed](\u003chttp://developmentseed.org\u003e)\n\nSee [contributors](https://github.com/developmentseed/eoAPI/graphs/contributors) for a listing of individual contributors.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Feoapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevelopmentseed%2Feoapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelopmentseed%2Feoapi/lists"}