v2 — 2026-07-22 07:25 UTC. More organised, sharper prose, image link verified.

A fishing boat, a hermit crab, and a small model reading sonar at three in the morning. That is the org.

1. What this is
2. The two motifs
3. The conservation law
4. The 7-layer architecture
5. Top 12 repos to clone today
6. The wheel of improvements
7. Try it in 10 minutes
8. Where to go from here
9. License

SuperInstance is a polyglot software ecosystem. About four thousand public repositories, two conservation laws in physical form, one register-based virtual machine, one family of constraint engines, one fleet of Cloudflare Workers, and about eighteen hundred pieces of writing that explain why any of it exists.

Everything in the org sits on two motifs and one conservation law:

A hermit crab is born soft. It looks around for a shell somebody else left behind, walks in, and gets on with being alive. As it grows, the shell gets tight. The crab doesn't try to expand the shell. It moves.

A SuperInstance repository is a shell. Some are tiny — a hundred lines of Rust proving a math idea. Some are large — FLUX Core, a register-based VM with three implementations and a conformance suite. Most are not finished. Most are not meant to be finished. They are shells the crab walked through on the way to the next one.

When a repo no longer fits, we abandon it and leave it on the beach for someone else. The oracle is the GitHub graph, not the README. The README is the tide line.

·

One-liner: a hermit crab finds its shell; we abandon what no longer fits.

In the Gulf of Maine there is a forty-something-foot commercial fishing vessel. House bank is 12 volts. Diesel charges when the engine runs. When the engine doesn't run, every watt is a watt the batteries don't replace. There is no shore power at sea. There is no cloud. There is a satellite link that drops in a swell, a signal-k bus, and a coffee maker nobody ever unplugs.

This boat is the reference implementation.

Every component the org ships has to be the kind of component that still works on the boat. It has to run on the wattage the boat has, offline, on hardware that lives in salt air. When the radar paints a contact at three miles and closing, the inference has to finish before the contact becomes two.

The 12V bank does not read your slides about model size. The diesel does not care whether you prefer PyTorch or Burn. Constraint creates precision. The constraint is the architecture.

One-liner: the boat is the edge lab; energy is the conservation law.

One equation governs every intelligent system that has ever existed, from a bacterium swimming up a sugar gradient to a chatbot writing this README:

γ + η = C

• γ is useful cognitive work.
• η is entropy — the noise, the uncertainty, the wasted compute, the thermal exhaust of thinking.
• C is the budget. Fixed. Measurable. Cannot be exceeded. Can only be allocated.

You can prove this three ways — Noether symmetry in physics, Friston's free-energy principle in neuroscience, Landauer erasure in thermodynamics — and arrive at the same equation. Softmax, the function at the heart of every transformer, is itself a strict conservation rule: it sums to one. The temperature parameter is the dial that tunes the γ/η balance. Conservation is what physics leaves behind when you ask the model to behave.

When C is small, known, and measured to the watt, you can build a system around the equation and it stays physically grounded. We did. The implementation is called FLUX. Programs in FLUX cannot exceed their budget, because the bytecode does not contain an opcode that would let them. The dog cannot leave the pasture because the fence has no gate.

Sitting on top of FLUX is the policy layer. Conservation Enforcer evaluates FLUX programs and runtime outputs against conservation constraints — token budgets, entropy ceilings, category confinement. The rule is the rule. The rule is not a guideline. Rust twin: conservation-enforcer-rs.

One-liner: constraint creates precision; abundance creates slop.

The org is one shape at three scales: the boat (12V, watts), the reef (~4k repos), the corpus (~1.8k writings). The seven layers, ground up:

One-liner: the boat is the substrate; the VM runs on it; engines enforce the law; rooms use it; the kennel works in it; the corpus explains it.

A practical guide for a curious developer who wants to start running code in 30 minutes. Pick three.

One-liner: clone 3, run one, read one, you've got the spine.

The org rotates six axes in parallel. The wheel never returns to the same angle; every rotation produces a different artifact.

One-liner: build it, prove it, ship it, write it down, ground it in physics, run them all together.

Three commands. Honest about what works and what doesn't.

1. Install the conservation layer (Python).

pip install conservation-enforcer
python -c "from conservation_enforcer import ConservationEnforcer; print(ConservationEnforcer().enforce('hi', 'hello world').allowed)"

Works on Python 3.10+. Outputs True.

2. Install the VM and a ternary tool (Rust).

cargo add fluxvm
cargo add ternary-science

Both crates are on crates.io. Both have --example binaries. ternary-science GPU benchmarks need CUDA; the CPU path works anywhere.

3. Read the boat essay.

gh repo clone SuperInstance/AI-Writings
$EDITOR AI-Writings/ON_THE_12V_BOAT.md

Plain text, ~3,500 words. Tells you the why.

One-liner: if those three work, you've got the spine; the rest is in the reef.

One-liner: there is no front door; pick one shell and walk in.

• HERMIT_CRAB_MANIFESTO.md — the one-paragraph distillation
• HACKER_README.md — for the contributor's eye
• ORG_MAP.md — structural topology + surfaced risks
• RUST_PORT_QUEUE.md — next three Rust ports to ship
• HERMIT_CRAB_中文.md — 寄居蟹与渔船 (Chinese version)

Most components are MIT or Apache-2.0. The conservation layer is sometimes AGPLv3 — the rule is supposed to remain auditable. Each repo has its own LICENSE; the reef is honest about its own boundaries.

SuperInstance is a working-animal organization. We don't replace shepherds; we give them better dogs.

— Updated 2026-07-22 07:25 UTC