The AWS Emulator that
actually runs locally

# Install on macOS
brew tap jaisrajms/homebrew-tap
brew install --cask jaiscloud-aws

# Or pull the Docker image
docker run -p 4566:4566 jaisraj/jaiscloud-aws:latest

# Start the AWS emulator
jaiscloud-aws start
# Listening on http://localhost:4566

# Point any AWS SDK at JaisCloud — set once, all calls route automatically
export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_REGION=us-east-1
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test

# Use exactly as you would with real AWS
aws s3 mb s3://my-bucket
aws sqs create-queue --queue-name my-queue
aws dynamodb list-tables
aws lambda invoke --function-name my-fn output.json

# .github/workflows/test.yml
jobs:
  test:
    runs-on: ubuntu-latest
    services:
      jaiscloud:
        image: jaisraj/jaiscloud-aws:latest
        ports: ["4566:4566"]
        env:
          JAISCLOUD_EPHEMERAL: "true"
    steps:
      - uses: actions/checkout@v4
      - name: Wait for AWS emulator
        run: until curl -sf http://localhost:4566/_jaiscloud/health; do sleep 1; done
      - name: Run tests
        env:
          AWS_ENDPOINT_URL: http://localhost:4566
          AWS_REGION: us-east-1
          AWS_ACCESS_KEY_ID: test
          AWS_SECRET_ACCESS_KEY: test
        run: go test ./...