Deploy AWS Serverless Apps with Clean, Modular YAML
EasySAM is an opinionated YAML-to-SAM generator for AWS Lambda, API Gateway, DynamoDB, S3, SQS, Kinesis, OpenSearch, and IoT Core.
uv add --dev easysam
Why EasySAM?
Everything you need to build, test, and deploy production-ready AWS SAM stacks faster.
YAML-First Model
Define Lambda functions, API routes, DynamoDB tables, and S3 buckets in compact, readable resource definitions.
No-Docker Local Execution
Mock API Gateway and invoke Lambda handlers locally in milliseconds without spinning up heavyweight Docker containers.
Recursive Imports
Structure large applications into clean modules with resources.yaml and local easysam.yaml files.
Environment & .env
Automatic .env file loading, ${VAR} expansion, contextual overrides, and conditional resources per environment.
Native Triggers
Seamlessly wire DynamoDB Stream triggers, SQS queues (standard & FIFO), Kinesis streams, Function URLs, and MQTT authorizers.
Prismarine Integration
Model-driven table definitions with auto-generated typed clients using TypedDict or Pydantic. Learn more →
Quick Start (5 Minutes)
Get up and running with EasySAM in four simple steps.
Initialize Project
Create a project and initialize EasySAM configuration:
mkdir my-easysam-app
cd my-easysam-app
uv init
uv add --dev easysam
uv run easysam initDefine Resources
Write a minimal resources.yaml configuration:
prefix: MyApp
import:
- backendValidate & Generate
Inspect your schema and build the final SAM template:
# Validate schema
uv run easysam --environment dev inspect schema .
# Generate template.yml
uv run easysam --environment dev generate .Deploy to AWS
Deploy your SAM stack directly to your AWS environment:
uv run easysam --environment dev --aws-profile my-profile deploy .Companion Agent Skills
Pair EasySAM with AI coding agents using ready-made skills for scaffolding, resource management, and deployment.
EasySAM Skill
Scaffold projects, add functions, tables, and queues with schema validation, and generate CI/CD workflows using uv and OIDC.
Prismarine Skill
Define type-safe DynamoDB models, generate client code, and wire models to serverless resources with guided workflows.
npx skills add https://github.com/scartill/easysam-skills
Documentation & Resources
Explore comprehensive guides, references, and examples.
Detailed breakdown of commands for generation, local testing, validation, and deployment.
Full reference guide for supported AWS resources, properties, and configurations.
Best practices for deploying secure, resilient serverless applications in production.
Hands-on examples covering DynamoDB, OpenSearch, IoT authorizers, Kinesis, and more.
The companion DynamoDB ORM: define type-safe models and generate client code that plugs into EasySAM tables.
Companion skills for AI coding agents to scaffold, manage, and deploy EasySAM and Prismarine projects.
Contributors
Built and maintained by these humans.
