lambda-mvp-glj, user guide

lambda-mvp-glj runs Glojure, Clojure hosted on Go, on AWS Lambda as a custom runtime. The Runtime API loop is written in Glojure and calls Go's net/http directly, and Glojure compiles it ahead of time into Go, so the whole function ships as one static bootstrap binary.

It's the Go member of the lambda-mvp-* family, and it has the same handler, the same response shape and the same bench task as the others. In this account it had the quickest cold start and the smallest memory footprint of the four siblings benched on 2026-11-14.

The aws commands use whatever your CLI already has configured (AWS_PROFILE/AWS_REGION, or aws configure). No profile, account or region is hardcoded, so the commands behind this guide's numbers will give you yours.

How to read this guide

To get it running, start with Getting started. You need Go and babashka, and Docker only if you want LocalStack. It goes from the offline probe to a live deploy and back to a clean account.

From Glojure source to a bootstrap binary explains how a .glj namespace becomes Go, how the loop talks to net/http, and the two snags that each cost a debugging round. Read it before you add a namespace.

Cold vs. warm boot has this project's numbers and a same-day table against the shadow-cljs, Clojurific and Jolt siblings. Check the deployment-model caveat before comparing columns.

Running against LocalStack covers the deploy, invoke and teardown cycle against a local emulator instead of a real account.

Guide map

PageWhat you'll learn
Getting startedRequirements, the offline probe, a first deploy, teardown
From Glojure source to a bootstrap binaryThe three namespaces, Go interop, the AOT build, the gotchas
Cold vs. warm bootWhat bb bench measures, this project's numbers, the same-day comparison
Running against LocalStackThe full lifecycle without an AWS account

Find your scenario

ScenarioPages to read
"I want to try it"Getting started
"I want to know how Clojure on Go gets to Lambda"From Glojure source to a bootstrap binary
"I'm comparing Clojure runtimes for Lambda"Cold vs. warm boot
"I don't have an AWS account handy"Getting started, then Running against LocalStack

See also