aws-ai-availability

Offline, JSON-backed JavaScript/TypeScript library that answers:

Which AWS AI services / models can I use, and in which regions?

No live AWS API calls at runtime. Data ships as a versioned snapshot bundled with the package.

Unofficial / community-maintained. This is not an AWS product and does not imply AWS endorsement. Treat the dataset as a point-in-time snapshot, not a live source of truth. AWS AI region rollout changes frequently — check metadata.generatedAt and metadata.sourceUrls before relying on answers.

Install

npm install aws-ai-availability

Requires Node ≥ 18. ESM and CJS builds are published. Browser bundlers can import the ESM entry (or tree-shakeable data/*.json subpaths).

Quick start

import {
  getModelsByRegion,
  isModelAvailable,
  getMetadata,
} from "aws-ai-availability";

const meta = getMetadata();
// meta.dataVersion === "data-2026.09.24"
// meta.generatedAt, meta.sourceUrls
// meta.requestTagging?.support === "Native (Inference Profiles & Logs)"

const models = getModelsByRegion("eu-central-1", { mode: "geo" });

const available = isModelAvailable(
  "anthropic.claude-sonnet-5",
  "ap-southeast-3",
  "global",
);

API (synchronous / pure)

| Function | Description | |----------|-------------| | getServicesByRegion(regionCode) | AI services available in a region | | getModelsByRegion(regionCode, opts?) | Models in a region; optional mode: "inRegion" \| "geo" \| "global" | | getRegionsForModel(modelId) | Regions + access modes for a model | | isModelAvailable(modelId, regionCode, mode?) | Boolean availability check | | listModels(filter?) | Filter by provider, modality, service, deprecation | | listRegions(filter?) | Filter by partition or geography | | listProviders() | Model providers | | getModelDetails(modelId) | Full model record | | getMetadata() / getDataset() | Staleness metadata / full dataset | | createQueryEngine(dataset) | Build an API over a custom/fixture dataset |

Core query API has zero runtime dependencies.

Access modes (Bedrock)

• inRegion — strict single-Region processing (availability.inRegion)
• geo — geographic cross-Region inference profiles (availability.crossRegionProfiles)
• global — Bedrock global routing (availability.global)

Data layout & pinning

Split JSON (tree-shakeable subpath exports):

data/metadata.json
data/regions.json
data/providers.json
data/services.json
data/models.json
schema/dataset.schema.json

import models from "aws-ai-availability/data/models.json" with { type: "json" };

Dataset version is independent of the code API semver, e.g. data-2026.09.24 in metadata.dataVersion. Pin both if you need reproducibility:

{
  "dependencies": {
    "aws-ai-availability": "0.2.0"
  }
}

Then assert getMetadata().dataVersion === "data-2026.09.24" in CI.

Request tagging

getMetadata().requestTagging describes how to attach cost and trace tags on Bedrock calls. 0.2.0 support: Native (Inference Profiles & Logs).

• Application Inference Profile ARN (resource) — resource-level cost allocation tags
• X-Amzn-Bedrock-Trace-Id (header) — logged to S3 and CloudWatch

const tagging = getMetadata().requestTagging;
// tagging.example
// arn:aws:bedrock:us-east-1:123456789012:application-inference-profile/my-app-prod

CLI

npx aws-ai-availability regions --model anthropic.claude-sonnet-5
npx aws-ai-availability models --region us-east-1 --mode geo
npx aws-ai-availability services --region eu-central-1
npx aws-ai-availability model anthropic.claude-sonnet-5
npx aws-ai-availability available --model anthropic.claude-sonnet-5 --region ap-southeast-3 --mode global
npx aws-ai-availability metadata

Refreshing data

npm run build:data

Assembles data/*.json, runs referential sanity checks, and writes artifacts/dataset.assembled.json for CI diffs. A weekly GitHub Action can regenerate data and open a PR when the assembled artifact changes.

v1 ships an illustrative seed catalog aligned with the explorer demo. Production refresh should pull Bedrock via foundation-model APIs / docs and non-Bedrock services from the AWS Regional Services List.

License

MIT. Unofficial community data — not affiliated with Amazon Web Services.

Monorepo

See docs/MONOREPO.md. Explore in the UI: npm run ui (AWS tab).