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.3.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.3-py3-none-any.whl (639.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: eoapi_cdk-11.6.3.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.3.tar.gz
Algorithm Hash digest
SHA256 6a87daae16e576c204746a58a757cb3ee7249075b506b69634d5605c98363a8b
MD5 85ab6e22cb79ac29d2913df76ce12cf6
BLAKE2b-256 b7efd8223fee339b3a4d7c900fa13c030c43aa9c2896e698d7861adba036a782

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: eoapi_cdk-11.6.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 81876d219ad229179af6dd2e4b1255bebe4d15c6c908ac65c812949cbbe8d687
MD5 5c8f8f1cb4308bf29b9ce3e56b523c86
BLAKE2b-256 44b3c1c1cd03bedb8a55b883f30f11862aa3ee16ba7d9c0ace342587350dac2e

See more details on using hashes here.

Provenance

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

This release

11.6.3 This release

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