kumolo

What is kumolo?

kumolo runs as a standalone server that accepts standard AWS SDK v2 requests. No mocking, no stubs — designed to behave like real AWS.

Goal: if it works on kumolo, it works on real AWS — and vice versa.

Drop-in compatible

Point your existing AWS SDK at http://localhost:5566. No code changes needed.

High fidelity

Behaves like real AWS — error codes, response shapes, and edge cases included.

Fast iteration

No network latency, no AWS bills, no IAM headaches during local development.

Supported services

DynamoDB, KMS, S3, STS and more →

Already using AWS SDK v2?

Just point your client at kumolo — no other code changes needed.

Go

client := s3.NewFromConfig(cfg, func(o *s3.Options) {
    o.BaseEndpoint = aws.String("http://localhost:5566")
    o.UsePathStyle = true
})

Python

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="http://localhost:5566",
    aws_access_key_id="test",
    aws_secret_access_key="test",
    region_name="us-east-1",
)

TypeScript

import { S3Client } from "@aws-sdk/client-s3";

const client = new S3Client({
    endpoint: "http://localhost:5566",
    forcePathStyle: true,
    region: "us-east-1",
    credentials: {
        accessKeyId: "test",
        secretAccessKey: "test",
    },
});

The same pattern applies to all other services — omit UsePathStyle and set only BaseEndpoint.

Quick Start

docker run -p 5566:5566 ghcr.io/optiflowic/kumolo:latest

Point your AWS SDK at http://localhost:5566 — no other changes needed.

Full installation guide →