# aws/aws-sam-cli

CLI tool to build, test, debug, and deploy Serverless applications using AWS SAM

Repository: https://github.com/aws/aws-sam-cli
Canonical: https://ross.abutalabs.com/products/aws-sam-cli
Homepage: https://aws.amazon.com/serverless/sam/
Language: Python
License: Apache-2.0
License Family: permissive
Topics: serverless, aws, lambda, serverlessapplicationmodel, sam, docker, api-gateway, python
Last push: 2026-08-26T23:04:55+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 95, longevity 100
- inputs: {"age_days": 3389, "days_push": 7, "days_rel": 33, "gap_med": 13, "n_releases_24m": 50}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6732, forks 1238 (observed 2026-08-28T04:09:48.154743+00:00)

## What it is
AWS SAM CLI is an open-source command-line tool for building, locally testing, debugging, and deploying serverless applications defined with AWS SAM or CloudFormation templates. It supports Lambda, API Gateway, Step Functions, and event services, with local Docker-based emulation and cloud sync via SAM Accelerate.

## Use cases
- initialize a serverless project from a template
- build and package lambda functions locally
- run and test lambda and api gateway locally in docker
- deploy sam or cloudformation templates to aws
- sync local code changes to the cloud for fast testing
- tail cloudwatch logs and x-ray traces
- generate ci/cd pipeline templates

## When to choose
- you develop AWS Lambda-based serverless applications
- you want local emulation of Lambda and API Gateway before deploying
- you use SAM or CloudFormation templates for infrastructure as code
- you want fast cloud sync and debugging with SAM Accelerate

## When to avoid
- you deploy serverless functions to non-AWS clouds
- you prefer container-based or Kubernetes serverless runtimes
- you need a general-purpose IaC tool beyond serverless apps (e.g., Terraform for all resources)
- your project has no AWS Lambda or API Gateway components

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, infrastructure-as-code, deployment, developer-tools, testing, ci-cd
- domain: cloud-computing, developer-tools
- platform: cli, python, cross-platform, cloud
- tags: aws, lambda, sam, cloudformation, api-gateway, serverless-framework, local-testing, infrastructure-as-code, serverless, devops, automation, docker

## Member repositories
- aws/aws-sam-cli (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:48.154743+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:42:48.404173+00:00, confidence not recorded.
  - readme: https://github.com/aws/aws-sam-cli (fetched 2026-08-28T04:09:48.154743+00:00, sha 7ef3bb2ad8d7)
  - homepage: https://aws.amazon.com/serverless/sam/ (fetched 2026-08-29T08:39:01.810384+00:00, sha 10549a92c979)
  - site_page: https://aws.amazon.com/getting-started?nc2=h_dsc_aa_gs (fetched 2026-08-29T08:39:01.822974+00:00, sha f35fd0664950)
  - site_page: https://aws.amazon.com/about-aws/global-infrastructure?nc2=h_dsc_aa_gi (fetched 2026-08-29T08:39:01.824863+00:00, sha 79a446e5fbd1)
  - registry_pypi: https://pypi.org/pypi/aws-sam-cli/json (fetched 2026-08-29T08:39:01.842890+00:00, sha a93decf0198a)
  - site_page: https://aws.amazon.com/products/developer-tools/agent-toolkit-for-aws?nc2=h_dsc_ex_s5 (fetched 2026-08-29T08:39:01.820082+00:00, sha 3cc21b596f92)
  - site_page: https://aws.amazon.com/pricing?nc2=h_pr_hub (fetched 2026-08-29T08:39:01.826707+00:00, sha e2abd01d7981)
  - site_page: https://aws.amazon.com/savingsplans?nc2=h_pr_sp (fetched 2026-08-29T08:39:01.828631+00:00, sha 9ff3c7ad93e0)
  - site_page: https://aws.amazon.com/s3/pricing?nc2=h_pr_s3 (fetched 2026-08-29T08:39:01.831357+00:00, sha 97bbf99c3793)
  - site_page: https://aws.amazon.com/bedrock/pricing?nc2=h_pr_br (fetched 2026-08-29T08:39:01.836660+00:00, sha 4ccc538a3696)
- Data as of 2026-08-30T08:39:29.467469+00:00.