WANTED is Public: The Repo, the Docs, and What's Actually Built
Overview
Last post I laid out the uncomfortable truth: you wouldn't deploy your backend as a single statically-linked binary on an unpatched server — yet that's exactly how we treat the µCs running our homes and factories. I argued that the monolith brings fragility, operational friction, and a codebase nobody wants to touch.
I said there was an alternative, and that it would be public soon.
It is public now.
The repository and the docs
I'd rather show you what's solid, what's half-built, and what's still a sketch than dress a side-project runtime up as a finished product. So here's the whole thing, warts and all — engine source, the test suite, and the sample Wapp builds:
It's Apache 2.0 — fork it, ship it, vendor it into something bigger; no license friction with the rest of the cloud-native stack.
For a runtime nobody's seen yet, the docs matter as much as the code, so they went up alongside it — architecture, the runtime spec, the Sheriff control plane, and the capability model:
That landing page is the canonical reference for the rest of this series.
The stack
WANTED is more than the runtime; it's a full stack for edge autonomy, in three layers:
- Runtime: A WebAssembly Micro Runtime (WAMR)-based engine that provides a sandboxed, capability-gated environment for application code.
- Supervisor (Sheriff): An on-device control-plane agent that manages the Wapp lifecycle, enforces resource limits, and reconciles desired state against the physical reality of the device (will also be public soon).
- Cloud (Marshal/Deputy): The control-plane layer, currently in design. Marshal targets Kubernetes-native GitOps orchestration; Deputy is a lightweight standalone binary for local orchestration with no cluster dependencies — a single binary with a web UI and optional MQTT Discovery for Home Assistant users.
The honesty table
This is a one-person project in active early development, so here's what actually compiles and passes CI today versus what's still a branch or a sketch — no roadmap theater:
| State | Components |
|---|---|
| Built & merged | VFS router (namespace isolation), TarFS + OCI layered images, WAMR 2.4.4 classic-interpreted runtime, Linux platform, NuttX simulation target (CI-gated, functional selftest suite), named-pipe IPC, per-wapp console driver, WASI args/environ passthrough, the on-device Sheriff supervisor (initial control-plane primitives) - currently in compiled wasm form in repo, but source code will be available. |
| In progress | NuttX ESP32 hardware, the Sheriff reconciliation loop, Deputy and Marshal control planes (in design). |
| Research | Checkpoint/Restore, delta OTA, Execute-In-Place (XIP) from Flash, RISC-V target support. |
Try it today
No exotic hardware required: clone it, build on Linux, and have a "hello from the edge" Wapp running in a few minutes.
The Quickstart walks the whole loop — compile to wasm32-wasi, package it into an OCI
image, and launch it through the control plane.
What's coming
This was orientation. The next posts go subsystem by subsystem, bytecode up:
- Part 3: WebAssembly on Bare Metal
- Part 4: Hardware as Files: The VFS Capability Model
- Part 5: OCI Images on an RTOS
- Part 6: The Control Plane
- Part 7: Real Deployments
- Part 8: Checkpoint/Restore
Star the repo if it's useful, follow the series, and open an issue when I get something wrong — this is the edge infrastructure I wanted and couldn't buy, built in the open.
Posts in this series
- Your Firmware is a Monolith. Fix It.
- WANTED is Public: The Repo, the Docs, and What's Actually Built