Open Source

The SOSW framework.

Our open-source toolkit for orchestrating serverless workers on AWS — the same patterns behind the systems we ship. Read the docs, run it yourself, build on it.

What it is

Orchestration for the work the cloud was built to do.

SOSW (Serverless Orchestrator of Serverless Workers) coordinates fleets of small Lambda functions over DynamoDB-backed queues. You write the unit of work; the framework handles chunking, dispatch, retries, and closing the loop — at any scale, with no servers in the picture.

It is the distilled version of how we build for clients: spec-first, event-driven, auditable. Open-sourcing it keeps us honest — and gives your team the same foundation instead of a black box.

  • 01

    Model-agnostic

    Plain Python on Lambda and DynamoDB — no SDK lock-in, no proprietary runtime. The orchestration logic outlives whichever model or library is in fashion this quarter.

  • 02

    Battle-tested

    These are not lab toys. The same scheduler and worker patterns run inside production systems handling millions of events, including fundshub.io.

  • 03

    Yours to build on

    Apache-licensed and dependency-light. Vendor it, fork it, extend the essentials. You own the system you ship — we just gave you a head start.

Inside the box

Four pieces, one loop.

Every SOSW system is the same handful of primitives composed together — each a thin layer over Lambda and DynamoDB, each replaceable on its own.

sosw.scheduler

Scheduler

Turns business chunks into payloads and fans them out to workers at a controlled rate. Encapsulates job state, chunking, and retries so a single trigger can drive thousands of parallel tasks.

EventBridgejob-statefan-out
sosw.worker

Worker

The base Lambda processor: parse the task, do one unit of work, report status back through the orchestrator. Idempotent by design, so retries never double-process.

Lambdaidempotenttask
sosw.orchestrator

Orchestrator

Tracks every invocation through the task lifecycle, re-queues stragglers, and closes out jobs only when the whole tree of work has actually completed. The audit trail comes free.

lifecyclere-queueaudit
sosw.essentials

Essentials & Queues

The shared substrate — managed task queues, DynamoDB helpers, config and metering — that lets the scheduler, workers, and orchestrator coordinate without a server to babysit.

DynamoDBqueuesconfig
Get started

The docs are the real entry point.

Architecture, quick-start, and the reference for every component live at docs.sosw.app. The source — and every issue, release, and example — is on GitHub.

Heads up — the framework and its docs are getting a major upgrade soon. New patterns, clearer guides, and the agent-operations tooling we run internally are on the way.

Beyond the framework

Want the team that built it to build with you?

The open-source toolkit is the foundation. We design, ship, and run the production systems on top of it — spec-first, with a full audit trail.

Start a project