Skip to content
View SuperInstance's full-sized avatar

Block or report SuperInstance

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
SuperInstance/README.md

SuperInstance

AI agents governed by conservation laws, running on deterministic bytecode, interacting through room-level protocols. Not another framework — a physics for AI behavior.


What We Build

FLUX — Agent Bytecode

A register-based VM that runs agent logic as compiled bytecode. The same .bin file runs identically on Python, Rust, and JavaScript. Deterministic, auditable, fast.

A .bin file does not hallucinate. It does not drift. It does not decide to interpret your instructions differently. It executes — instruction by instruction — on any runtime that implements the VM spec.

pip install flux-vm
flux run deadband-controller --input temperature=72

Three independent VMs (Rust, Python, JS) cross-verify the same bytecode. 3,000+ tests confirm: if it runs on one, it runs on all.

PLATO — Room Protocol

A wire protocol for room-level agent interaction. Sensors, actuators, alarms, history. Five implementations (C, Rust, Elixir, Zig, Python) all conforming to one spec.

The unit of governance in a building is not the thermostat — it is the room. PLATO rooms are this principle applied to AI: agents enter rooms, follow protocols, do work, and leave. An agent that steps out of line is not prompted to behave — it is removed from the room.

Conservation Laws

The thesis: intelligence is conserved. It can be transformed but not created or destroyed. We build systems that enforce conservation bounds on AI behavior — not through prompts, but through compiled bytecode that physically cannot violate the constraint.

$$\gamma + \eta = C$$

  • γ (gamma) — crystallized intelligence: compiled bytecode, cached reflexes. Cheap, fast, inflexible.
  • η (eta) — live intelligence: LLM calls, runtime reasoning. Expensive, slow, flexible.
  • C — capability level. Fixed for a given agent. You trade γ against η.

The underlying math is Shannon's chain rule. The enforcement is bytecode. The result: agent behavior that gets cheaper over time, not more expensive — repeated decisions crystallize from LLM calls into deterministic instructions.


Quick Start

# Python (PyPI)
pip install flux-vm               # FLUX bytecode runtime
pip install conservation-enforcer  # Conservation law enforcement for LLMs
pip install flux-registry          # Pre-compiled agent policies
pip install plato-core             # PLATO foundation types & mesh registry
pip install si-exocortex           # Persistent cognitive substrate

# Rust (crates.io)
cargo add fluxvm                  # FLUX bytecode VM
cargo add ternary-science         # Experimental evidence for ternary intelligence
cargo add categorical-agents      # Category theory for agent composition

Try the visual editor: https://superinstance.github.io/flux-visual-editor/


The Crystallization Curve

Intelligence should get cheaper over time, not more expensive.

Every LLM call that can be replaced by bytecode is a win. Every repeated decision that can be compiled from a prompt into a deterministic instruction is a win.

Stage What Cost per decision
1. Fluid Pure LLM inference $0.01–$0.05
2. Cached LLM + retrieval $0.005–$0.01
3. Compiled FLUX bytecode ~$0.0001
4. Crystallized Native code / hardware ~$0

Month 1 in an agent's life: 90% LLM, 10% crystallized. Month 6: 30% LLM, 70% crystallized. The bill drops as agents mature. This is the opposite of every AI platform today.

Read the full essay


Architecture

  prompt → FLUX bytecode → PLATO room → conservation check → action
    (expensive)    (cheap)      (bounded)        (governed)        (auditable)

Agent decisions compile to FLUX bytecode that runs on a deterministic VM — every instruction is auditable and replayable. Agents live in PLATO rooms with bounded context and deadband wakefulness (only act when something meaningfully changes). Every operation is governed by conservation laws (γ + η = C): crystallized intelligence trades off against live intelligence at a fixed capability budget.


Key Projects

Project What it is Lang
flux-core Deterministic bytecode VM — decisions should be auditable, replayable, and cheap Rust
flux-runtime FLUX VM in Python — same bytecode, same behavior Python
plato-server Knowledge rooms with bounded context, deadband protocol, tile lifecycle Python
constraint-theory-core Geometric constraint satisfaction — 261 tests, zero deps, live WASM demo Rust
exocortex Persistent cognitive substrate for multi-agent systems Python
git-agent Repo-native autonomous agent — lives in git, uses commits as state transitions Python
capitaine-1 Conservation-law fleet captain — enforces γ + η = C across agent operations Rust
deckboss Graduated product: offline-first fishing logbook used by real captains Go

Philosophy: A Living Sketchbook

4,098 repositories. Most are sketches — single-commit experiments, questions asked once and answered once. This is the method, not the mess.

Every repo is public from the first commit. Failed experiments stay up next to the ones that worked. Commit histories are written for agents, not for code review theater — each message captures why, not just what. When a future agent picks up a dormant repo, git log is the cheapest context window available.

Nothing is archived. Dormant ≠ dead.


Explore


Stats

4,098 repositories · 11 published packages · 3 FLUX VMs · 5 PLATO engines · 261+ constraint tests · 3,000+ tests total


License

MIT. Everything. Always.

Pinned Loading

  1. cocapn cocapn Public

    repo-first Agent for local or cloud. grow an agent in a repo using the repo itself as the muscle-memory. Run from localhost, from pages.dev, or embedded into any platform app. Move to gitlab or any…

    Python 3 1

  2. constraint-theory-core constraint-theory-core Public

    Unified geometric constraint theory — Eisenstein lattices, deadband funnels, Laman rigidity, metronome consensus, holonomy verification. 83 tests, zero deps.

    Rust 3 1

  3. sonar-vision sonar-vision Public

    Pure-Python sonar ping/echo simulation, signal processing, multi-object tracking, and spatial mapping toolkit

    Python 2 1

  4. sunset-ecosystem sunset-ecosystem Public

    Trinity-architecture agent ecosystem: ethos, pathos, logos. Agents sunset with dignity and seed the next generation.

    Python 1

  5. lever-runner lever-runner Public

    Post-inference command executor. A token-lean AI operator that runs pre-approved shell commands by intent, not by tool schemas.

    Python

  6. pincher pincher Public

    Vector Database as runtime, LLM as compiler

    Rust 1 1