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 5, 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:
Newer release available (11.6.4)

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 5, 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.2.tar.gz (640.9 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.2-py3-none-any.whl (639.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: eoapi_cdk-11.6.2.tar.gz
  • Upload date:
  • Size: 640.9 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.2.tar.gz
Algorithm Hash digest
SHA256 955f4d62228a1a1190dbe5821b1a1a2d88c50194bd175d7464997f4ef428e087
MD5 acfdb0daddb36236fb26aeb966635a8a
BLAKE2b-256 959e4181efb94ea47d4f739a4993efb5e5e4864a382ec263b812729377b94432

See more details on using hashes here.

Provenance

The following attestation bundles were made for eoapi_cdk-11.6.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: eoapi_cdk-11.6.2-py3-none-any.whl
  • Upload date:
  • Size: 639.5 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 366d533b6cece7a392dcade5813f9f527e0129b0976e167e85c16e5717328ee0
MD5 70e5893f6a1eedf1e5bc2e4b9e76d3e7
BLAKE2b-256 286bc3480b158a6e7c235beda75fb72dbe6970c7982f88b9f8bdc6d82d76596c

See more details on using hashes here.

Provenance

The following attestation bundles were made for eoapi_cdk-11.6.2-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

11.6.4

2 files

11.6.3

2 files

This release

11.6.2 This release

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