Documentation
Everything you need to install, configure, and use LocalEmu. 132 AWS services, 9,000 API operations, all running on your machine.
Get started in 10 seconds
Install, start, and create your first S3 bucket.
pip install localemu[runtime] localemu start awsemu s3 mb s3://my-bucket Getting Started
Services & Coverage
End-to-End Tutorials
Image Pipeline
S3 upload, Lambda resize, DynamoDB metadata
REST API
API Gateway, Lambda, DynamoDB CRUD
Event-Driven Fan-out
SNS, SQS, Lambda fan-out pattern
Batch ETL
S3 ingestion, Lambda transform, DynamoDB load
Scheduled Job
EventBridge rule, Lambda, CloudWatch Logs
S3 Guardrail
S3 event, Lambda validation, SNS alert
Payment Ledger
API Gateway, Lambda, DynamoDB Streams, SQS
LLM Gateway
API Gateway, Lambda, Secrets Manager, DynamoDB
Integrations
Reference
Service References
Lambda
Docker-backed runtimes, layers, ESM, function URLs
S3
Custom Python impl with persistence, multipart, versioning, event fan-out
DynamoDB
Pure-Python Moto backend, full streams, transactions, global tables
SQS
Custom impl: FIFO + standard, real visibility tracker, DLQ + redrive, CloudWatch metrics
SNS
Custom impl: 9 protocols, FIFO topics, filter policies, per-subscription DLQ
EventBridge
16 target types, 11 pattern operators, archives + replays, API destinations, scheduled rules
Step Functions
Pure-Python ASL interpreter, 8 state types, 11 service integrations, 18 intrinsics
KMS
Real AES-256-GCM, RSA, ECC, HMAC via cryptography lib, grants, aliases, rotation, multi-region keys
Secrets Manager
Real Lambda-driven 4-step rotation, version stages, resource policies, full persistence
Kinesis
Python SubscribeToShard event-stream generator, fault injection, resource policies, Lambda ESM
CloudWatch Logs
Real-time subscription dispatch to Lambda/Kinesis/Firehose, metric filters cross-publish to CloudWatch, full filter-pattern syntax
CloudWatch (metrics + alarms)
SQLite-backed metric store, real alarm scheduler thread with SNS/Lambda action dispatch, composite alarms, full dashboard CRUD
Amazon MQ
Real rabbitmq:3.13-management container per broker, ephemeral-port mapping for amqp/amqps/mqtt/stomp/mgmt-UI, label-driven persistence
Amazon MSK (Kafka)
Real apache/kafka 3.7.1 broker in KRaft mode, PLAINTEXT bootstrap on the host loopback, full Kafka wire protocol via the upstream broker
Athena
Real DuckDB query engine reading Parquet/CSV/JSON/ORC from S3 through Glue Catalog, CTAS + INSERT INTO writing back to S3 and Glue
ECS
Real Docker container execution for FARGATE + EC2 launch types, awsvpc attachment, IAM task role credentials at 169.254.170.2
EKS
Real Kubernetes cluster via k3d (k3s in Docker), kubectl-accessible API server, real Pod scheduling + exec, CreateNodegroup spawns real agent nodes
SES + SES v2
All 110 v2 + 71 v1 ops; on-disk mailbox at /_aws/ses, Handlebars template substitution, v1 dispatches configuration-set events to SNS/Firehose/EventBridge
Kinesis Firehose
Real delivery to S3 (AWS-pattern keys), HTTP endpoints (POST envelope), OpenSearch (real indexing), Redshift (real INSERTs); Lambda transform processors run for real
EventBridge Pipes
All 10 ops greenfield, SQS source poller + filter criteria + JSONPath InputTemplate, real dispatch to Lambda/SQS/SNS/Step Functions/EventBridge/Kinesis
EventBridge Scheduler
Real 1 s polling thread + 32-worker dispatch pool, rate/cron/at expressions with timezone, FlexibleTimeWindow jitter, ActionAfterCompletion=DELETE for one-shots
API Gateway (REST API)
Real HTTP runtime: AWS_PROXY/AWS/HTTP/HTTP_PROXY/MOCK integrations, VTL via airspeed, REQUEST + TOKEN Lambda authorizers, canary deployments, stage variable substitution
EC2 Docker Instances
SSH, SSM, IMDS
RDS Docker Databases
PostgreSQL, MySQL, MariaDB
OpenSearch
Real full-text search
Security Groups
TCP proxy enforcement