install

Additional install commands

macOS

Homebrewverified · 100%

brew install aws-sam-cli

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#aws-sam-cli

nixpkgs package indexes · pkgs/by-name/aw/aws-sam-cli/package.nix · source: api.github.com

Windows

Scoopverified · 92%

scoop install main/aws-sam-cli

Scoop official bucket manifest trees · bucket/aws-sam-cli.json · source: api.github.com

Windows Package Managerverified · 92%

winget install --id Amazon.SAM-CLI -e

Windows Package Manager source index · Amazon.SAM-CLI · source: cdn.winget.microsoft.com

overview

Package summary

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

Project links

Commands and aliases

sam

history

Project history and usage

AWS SAM CLI is the command-line companion to the AWS Serverless Application Model, used to build, test, debug, package, and deploy serverless applications defined with SAM templates.

Project history

The repository's public history begins in August 2017 as AWS SAM Local CLI, with early tags starting at v0.1.0. The README describes AWS SAM as an open-source framework with shorthand syntax for functions, APIs, databases, and event source mappings, and identifies this repository as the SAM CLI source code.

Over time the CLI became the everyday developer entry point for SAM: local Lambda-like execution, Docker-backed testing, packaging, deployment, guided configuration, and command references live in AWS's Serverless Application Model developer guide.

Adoption history

SAM CLI adoption tracks the broader AWS serverless workflow. It gives local and CI users a packageable command named sam while the SAM template language remains CloudFormation-compatible infrastructure definition.

The supplied package facts list Homebrew, Nix, Scoop, and winget availability, which matches a cross-platform AWS developer tool: local laptops, CI runners, and onboarding scripts all need a stable installer story.

How it is used

Typical commands include sam init, sam build, sam local invoke, sam local start-api, sam deploy, and guided configuration flows. The official docs describe a project-level SAM CLI configuration file for command parameter values.

The default config name is samconfig at the project root next to template.yaml, with TOML as the default format and YAML/YML also supported. AWS credentials are inherited from the standard AWS SDK/CLI credential chain, including shared credentials files.

Why package nerds care

For package maintainers, SAM CLI is a heavyweight Python/AWS developer tool whose release cadence matters because AWS service behavior, Lambda runtimes, and local emulation expectations move quickly. The executable is small from the user's point of view but represents a large AWS workflow surface.

Timeline

2017: Repository history begins as AWS SAM Local CLI and v0.1.0 is tagged.
2018: v0.x releases add and evolve SAM CLI functionality.
2020: README screenshots and docs show SAM CLI as the front door for local build/test/deploy workflows.
2026: v1.x development tags show continuing active release work.

Related projects

AWS Serverless Application Model is the template framework the CLI operates on.
AWS CloudFormation is the deployment substrate SAM extends.
Docker is used by SAM CLI for local Lambda-like execution workflows.

Sources

https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-command-reference.html
https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-config.html
https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/using-sam-cli.html
https://github.com/aws/aws-sam-cli#readme
official git history and tags from https://github.com/aws/aws-sam-cli

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for aws-sam-cli. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Installs with 7 runtime dependencies.
Build metadata lists 3 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: samconfig.tomlsamconfig.yamlsamconfig.yml

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix: ~/.aws/credentials
Windows: C:\Users\USERNAME\.aws\credentials

executables

Installed executables

Command	Kind	Exposure	Note
`sam`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version1.163.0

manager updated2026-07-03

local dataok

upstreamnot checked

latest detectednot detected

https://aws.amazon.com/serverless/sam/

infoRelease/tag comparison is only available for GitHub repositories.https://aws.amazon.com/serverless/sam/none confidence

install metadata

Package metadata

Package key	brew:aws-sam-cli
Version	1.163.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/aws-sam-cli
Homepage	https://aws.amazon.com/serverless/sam/
Repository	https://github.com/aws/aws-sam-cli
Upstream docs	https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-command-reference.html
License	Apache-2.0
Source archive	https://files.pythonhosted.org/packages/96/03/3b7776b890db3aebe4e3bbcd4ba9e573066bf1dbe730f1301f69a09aa53a/aws_sam_cli-1.163.0.tar.gz
Last updated	2026-07-03T03:58:21Z
Pulse	updated
Dependencies	certifi, cryptography, libyaml, openssl@3, pydantic, python@3.14, rpds-py
Build dependencies	cmake, go, pkgconf
Uses from macOS	libffi
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	aws-sam-cli
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

aws-sam-cli

nix profile install nixpkgs#aws-sam-cli

normalized package name match
Matched by: Aws Sam Cli

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/aw/aws-sam-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

Scoop95%

main/aws-sam-cli

scoop install main/aws-sam-cli

normalized package name match
Matched by: Aws Sam Cli

Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/aws-sam-cli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

winget95%

Amazon.SAM-CLI

winget install --id Amazon.SAM-CLI -e

normalized package name match
Matched by: Aws Sam Cli

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: Amazon.SAM-CLI from https://cdn.winget.microsoft.com/cache/source.msix

Scoop92%

extras/sam

scoop install extras/sam

installed executable or alias match
Matched by: Sam

Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/sam.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/aws-sam-cli.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install aws-sam-cli with Homebrew, Nix, scoop, winget