eoAPI CDK Constructs

eoapi-cdk is a package of AWS CDK constructs designed to encapsulate eoAPI services and best practices as simple reusable components.

[!IMPORTANT]

We would :heart: to hear from you! Please join the discussion and let us know how you're using eoAPI! This helps us improve the project for you and others. If you prefer to remain anonymous, you can email us at eoapi@developmentseed.org, and we'll be happy to post a summary on your behalf.

For more background on the included services see The Earth Observation API

Included constructs

Detailed API docs for the constructs can be found here.

pgSTAC Database

An RDS instance with pgSTAC installed and the Postgres parameters optimized for the selected instance type.

STAC API

A STAC API implementation using stac-fastapi with a pgSTAC backend. Packaged as a complete runtime for deployment with API Gateway and Lambda.

For runtime notes on event loops, Mangum lifespan handling, and SnapStart-aware database pool initialization, see lib/stac-api/runtime/README.md.

pgSTAC Titiler API

A complete dynamic tiling API using titiler-pgstac to create dynamic mosaics of assets based on STAC Search queries. Packaged as a complete runtime for deployment with API Gateway and Lambda and fully integrated with the pgSTAC Database construct.

STAC browser

A CDK construct to host a static Radiant Earth STAC browser on S3.

OGC Features/Tiles API

A complete OGC Features/Tiles API using tipg. Packaged as a complete runtime for deployment with API Gateway and Lambda. By default the API will be connected to the Database's public schema.

STAC Ingestor

An API for large scale STAC data ingestion and validation into a pgSTAC instance.

ingestor

Authentication for the STAC Ingestor API can be configured with JWTs authenticated by JWKS. To learn more about securing FastAPI applications with this approach see Securing FastAPI with JWKS (AWS Cognito, Auth0).

A sample Cognito-based authentication system is available at aws-asdi-auth.

Bastion Host

A bastion host is a secure gateway that provides access to resources in a private subnet. In this case it provides the ability to make administrative connections to eoAPI's pgSTAC instance.

Alt text

For more background on bastion hosts in AWS see this article.

And for configuration instructions for this construct see the docs.

Published Packages

Release

Versioning is handled via Conventional Commits and Release Please.

Commits merged to main are collected into a release PR. A maintainer reviews and merges that PR to cut a release. After the release is created on GitHub, the distribution workflow publishes the generated Python package to PyPI and the generated JavaScript package to npm.

The release workflow uses the DS_RELEASE_BOT_ID and DS_RELEASE_BOT_PRIVATE_KEY repository secrets to authenticate the release bot.

Tests

Each pull request to main is added to a merge queue so that a "deployment test" workflow can run before the merge actually happens. If the deployment fails, the merge is cancelled. Here is the definition of this workflow and the tests definition.

Project links

Data verified by PyPI on Aug 7, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

Owner

PyPI data
Data sourced directly from PyPI's database.

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for alukach from gravatar.com alukach

Credits

Author: Anthony Lukach<anthony@developmentseed.org>

GitHub Statistics

Data verified by PyPI on Aug 7, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

OSI Approved (ISC)

Requires

Python >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eoapi_cdk-11.6.4.tar.gz (641.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

eoapi_cdk-11.6.4-py3-none-any.whl (640.3 kB view details)

Uploaded Python 3

File details

Details for the file eoapi_cdk-11.6.4.tar.gz.

File metadata

  • Download URL: eoapi_cdk-11.6.4.tar.gz
  • Upload date:
  • Size: 641.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for eoapi_cdk-11.6.4.tar.gz
Algorithm Hash digest
SHA256 c9a8e8fe2852b78e9070f8174db80613a84d1d4625e6a0665b8cffbd65e1a1fd
MD5 89553292910fec933abcb5dd52a044d3
BLAKE2b-256 ff324a97680be094c057583ebc20358e7a50abd04d7a28ef85f6ed3a05968c40

See more details on using hashes here.

Provenance

The following attestation bundles were made for eoapi_cdk-11.6.4.tar.gz:

Publisher: distribute.yaml on developmentseed/eoapi-cdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file eoapi_cdk-11.6.4-py3-none-any.whl.

File metadata

  • Download URL: eoapi_cdk-11.6.4-py3-none-any.whl
  • Upload date:
  • Size: 640.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for eoapi_cdk-11.6.4-py3-none-any.whl
Algorithm Hash digest
SHA256 ccb5c8dbc8081cb44e215a47af32772367b5279ac812cea67fef287740af372d
MD5 bec8de4dfbcd6e290014cb0255f5dc58
BLAKE2b-256 a017e0e5ae397f3923e375c006b7433644795b7891902912417d8cd269e03862

See more details on using hashes here.

Provenance

The following attestation bundles were made for eoapi_cdk-11.6.4-py3-none-any.whl:

Publisher: distribute.yaml on developmentseed/eoapi-cdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

11.6.4 This release

2 files

11.6.3

2 files

11.6.2

2 files

11.6.0

2 files

11.5.0

2 files

11.4.1

2 files

11.4.0

2 files

11.3.1

2 files

11.3.0

2 files

11.2.0

2 files

11.1.2

2 files

11.1.1

2 files

11.1.0

2 files

11.0.0

2 files

10.4.3

2 files

10.4.2

2 files

10.4.1

2 files

10.4.0

2 files

10.3.0

2 files

10.2.5

2 files

10.2.4

2 files

10.2.2

2 files

10.2.1

2 files

10.1.1

2 files

Yanked

10.1.0

2 files

Yanked reason: titiler broken by missing libexpat.so.1

10.0.0

2 files

9.2.1

2 files

9.2.0

2 files

Pre-release

9.2.0rc8

2 files

Pre-release

9.2.0rc7

2 files

Pre-release

9.2.0rc5

2 files

Pre-release

9.2.0rc4

2 files

Pre-release

9.2.0rc3

2 files

Pre-release

9.2.0rc1

2 files

9.1.1

2 files

9.1.0

2 files

9.0.0

2 files

8.3.3

2 files

8.3.2

2 files

8.3.1

2 files

8.3.0

2 files

8.2.3

2 files

8.2.2

2 files

8.2.1

2 files

8.2.0

2 files

8.1.1

2 files

8.1.0

2 files

8.0.3

2 files

8.0.2

2 files

8.0.1

2 files

8.0.0

2 files

7.6.3

2 files

7.6.2

2 files

7.6.1

2 files

7.6.0

2 files

7.5.1

2 files

7.5.0

2 files

7.4.2

2 files

7.4.1

2 files

7.3.0

2 files

7.2.1

2 files

7.2.0

2 files

7.1.0

2 files

7.0.1

2 files

7.0.0

2 files

6.1.0

2 files

6.0.2

2 files

6.0.1

2 files

6.0.0

2 files

5.4.1

2 files

5.4.0

2 files

5.3.0

2 files

5.2.0

2 files

5.1.0

2 files

5.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page