# awslabs/aws-sam-local **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/awslabs-aws-sam-local).** _How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._ 6,734 stars · 1,226 forks · Python · Apache-2.0 ## Links - GitHub: https://github.com/awslabs/aws-sam-local - Homepage: https://aws.amazon.com/serverless/sam/ - awesome-repositories: https://awesome-repositories.com/repository/awslabs-aws-sam-local.md ## Description aws-sam-local is a Docker-based emulator used for running and debugging AWS Lambda functions and API Gateway configurations on a local machine. It provides a local execution environment that mimics the AWS Lambda runtime, allowing for the verification of function code and serverless application mocks before cloud deployment. The project utilizes a runtime orchestrator to manage ephemeral containers, replicating the isolated execution environment of cloud functions. It includes a serverless API gateway simulator and event mocking tools to synthesize payloads from sources such as Kafka and other cloud triggers. The tool supports the broader development cycle for the Serverless Application Model by enabling local prototyping of serverless APIs and simulation of various cloud event sources. It provides a debugging environment for identifying errors in serverless functions with full control over the execution state. ## Tags ### Development Tools & Productivity - [Local Lambda Simulation](https://awesome-repositories.com/f/development-tools-productivity/local-development-environments/local-lambda-simulation.md) — Simulates AWS Lambda runtimes locally to verify function behavior and event handling before cloud deployment. - [Local Emulation Environments](https://awesome-repositories.com/f/development-tools-productivity/local-emulation-environments.md) — Provides a local emulation environment that uses containers to simulate AWS cloud service behavior for development. - [AWS Local Development Environments](https://awesome-repositories.com/f/development-tools-productivity/aws-local-development-environments.md) — Provides a local simulation environment specifically tailored for developing and testing AWS Serverless Application Model configurations. - [Serverless Function Development Tools](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management/cloud-service-emulation-interception/cloud-infrastructure-emulation/serverless-function-development-tools.md) — Offers a local execution setup for identifying and fixing serverless errors with full control over function state. - [Serverless Worker Debugging](https://awesome-repositories.com/f/development-tools-productivity/interactive-debug-consoles/breakpoint-debugging/serverless-worker-debugging.md) — Enables detailed debugging of serverless functions with full control over execution state and breakpoints. - [Web API Prototyping](https://awesome-repositories.com/f/development-tools-productivity/rapid-prototyping-environments/web-api-prototyping.md) — Provides a local environment for prototyping and iterating on API Gateway request and response logic. - [Cloud Event Simulators](https://awesome-repositories.com/f/development-tools-productivity/action-execution-frameworks/multi-action-triggers/multi-press-input-triggers/input-event-simulators/event-stream-simulators/cloud-event-simulators.md) — Synthesizes mock event payloads from Kafka and other cloud triggers to validate function behavior. ### DevOps & Infrastructure - [API Gateway Simulators](https://awesome-repositories.com/f/devops-infrastructure/api-gateway-simulators.md) — Acts as a local proxy that mimics API Gateway behavior to test serverless endpoints. - [Serverless Deployment Tooling](https://awesome-repositories.com/f/devops-infrastructure/cloud-provisioning/serverless-deployment-tooling.md) — Includes utilities for defining and localizing the deployment of serverless applications using the SAM model. - [Ephemeral Docker Runtimes](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/virtual-cluster-docker-images/ephemeral-docker-runtimes.md) — Manages ephemeral Docker runtimes to create isolated environments for executing and testing cloud functions. - [Docker Container Lifecycle Automation](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-orchestrators/docker-container-lifecycle-automation.md) — Automates the lifecycle of ephemeral Docker containers to ensure each function request starts in a clean state. - [Container Runtimes](https://awesome-repositories.com/f/devops-infrastructure/container-runtimes.md) — Uses isolated container runtimes to mimic specific cloud execution environments on a local machine. - [Local Serverless Testing](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/serverless-execution-environments/serverless-function-runtimes/local-serverless-testing.md) — Simulates AWS cloud services locally to accelerate the development cycle for serverless architectures. - [Ephemeral Container Orchestrators](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-orchestrators/ephemeral-container-orchestrators.md) — Manages ephemeral Docker containers to replicate the isolated execution environment of cloud functions. - [Event Handler Interfaces](https://awesome-repositories.com/f/devops-infrastructure/event-pipelines/unified-event-normalizers/event-handler-interfaces.md) — Routes diverse inbound request types through a unified entry point to standardize event processing. ### Programming Languages & Runtimes - [Runtime Emulators](https://awesome-repositories.com/f/programming-languages-runtimes/python-language-features/multi-language-runtimes/serverless-lambda-runtimes/runtime-emulators.md) — Mimics the AWS Lambda runtime locally for running and verifying function code. ### Software Engineering & Architecture - [Event Source Integrations](https://awesome-repositories.com/f/software-engineering-architecture/event-sourcing/event-source-integrations.md) — Integrates local functions with diverse event sources such as Kafka, Kinesis, and API Gateway. ([source](https://awslabs.github.io/aws-lambda-powertools-python)) - [Mock Event Triggering](https://awesome-repositories.com/f/software-engineering-architecture/event-buses/event-bus-mocks/mock-event-triggering.md) — Simulates cloud event triggers by firing mock payloads into local function handlers. - [Event Mocking for Testing](https://awesome-repositories.com/f/software-engineering-architecture/event-buses/event-bus-mocks/mock-event-triggering/event-mocking-for-testing.md) — Synthesizes mock event data to simulate cloud triggers and gateways for local function testing. ### Part of an Awesome List - [Application Frameworks](https://awesome-repositories.com/f/awesome-lists/devtools/application-frameworks.md) — CLI tool for managing applications using the Serverless Application Model.