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

An open-source ecosystem for bounded, conservation-governed AI agents.

Most AI platforms get more expensive the more you use them. SuperInstance is building the opposite: agents that crystallize repeated decisions into cheap deterministic bytecode, so your bill goes down as your agents get smarter.


The Big Idea: 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. The pipeline moves ideas from expensive (LLM calls) to cheap (compiled bytecode at the edge).

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 user's bill drops as agents mature.

This is the opposite of every AI platform today. → Read the full essay


Quick Install

# Python (PyPI)
pip install flux-vm          # FLUX bytecode runtime
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

# JavaScript (npm — coming soon)
# npm install flux-js

See PACKAGES.md for the full catalog across all registries.


Key Projects

Project What it is Lang
flux-vm Deterministic bytecode VM for agent logic — decisions should be auditable, replayable, and cheap Rust
plato-server Knowledge rooms with bounded context, deadband protocol, tile lifecycle — RAG with walls and a thermostat Python
constraint-theory-core Geometric constraint satisfaction — 83 tests, zero deps, running behind a 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

Architecture in Three Sentences

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.

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

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. Old repos aren't tech debt — they're context storage, readable by any agent that knows git.


The Conservation Law

γ + η = 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 — genuinely sound. The small crates that implement it (ternary-entropy, conservation-action) are tested and correct. The governance model — enforcing conservation in CI/CD — is novel.


Links


Recent Activity

2026-07-12 — Major shipping session:

  • 📦 6 packages published: flux-vm & plato-core & si-exocortex on PyPI; fluxvm & ternary-science & categorical-agents on crates.io
  • 🏗️ 9 repos polished and shipped: flux-runtime, flux-core, flux-js, plato-server, plato-engine-block-c, plato-runtime-kernel, git-agent, capitaine-1, codespace-edge-rd, git-agent-codespace
  • 📋 PACKAGES.md — unified package catalog across PyPI, crates.io, and npm
  • ✍️ AI-Writings — essays and philosophy alongside the code
  • 🏴 Capitaine-1 — conservation-law fleet captain enforcing γ + η = C

All repos now have consistent READMEs, LICENSE files, and cross-links. See PACKAGES.md for the full catalog.


License

MIT

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