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
| Page | What you'll learn |
|---|---|
| Getting started | Requirements, the offline probe, a first deploy, teardown |
| From Glojure source to a bootstrap binary | The three namespaces, Go interop, the AOT build, the gotchas |
| Cold vs. warm boot | What bb bench measures, this project's numbers, the same-day comparison |
| Running against LocalStack | The full lifecycle without an AWS account |
Find your scenario
| Scenario | Pages 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
- Project README has the quickstart.
CHANGELOG.mdlists what changed and when.- lambda-mvp-jlt is the Jolt sibling, which this project's Runtime API loop and scripts are modelled on.