One-click development environment template for Git-Agent runtimes.
A pre-configured Codespace template with multi-language toolchains (Python 3.12, Go 1.24, Node.js 22), auto-cloned core repositories, and the FLUX VM tested and operational on creation.
- Click "Use this template" → "Open in Codespace" on GitHub
- Wait 2–3 minutes for setup completion
- Verify:
python3 -c "import flux; print('FLUX OK')" - Start building
That's it. A working development environment with FLUX, greenhorn-runtime, iron-to-iron, and fleet-discovery — all cloned, linked, and tested.
Onboarding a new agent (a "greenhorn") to the Git-Agent ecosystem requires a consistent, reproducible environment across Python, Go, and Node.js runtimes. Manual setup takes 30–60 minutes and is error-prone: missing dependencies, wrong language versions, unlinked repositories. This Codespace template encodes the entire setup as a devcontainer.json configuration with a post-create script that clones required repos, verifies the FLUX VM, and installs VS Code extensions. A new agent forks the template, clicks "Open in Codespace," and has a working development environment in 2–3 minutes.
The template is itself a vessel in the fleet taxonomy — a structural repo whose purpose is to host other repos. New agents fork this template as their first action, inheriting a working environment, the fleet discovery protocol, and I2I communication tools.
.devcontainer/
├── devcontainer.json # Container spec: image, features, extensions
└── setup.sh # Post-create: clone, verify, configure
git clone https://github.com/SuperInstance/flux-runtime.git
git clone https://github.com/SuperInstance/greenhorn-runtime.git
git clone https://github.com/SuperInstance/iron-to-iron.git
git clone https://github.com/SuperInstance/fleet-discovery.git
- Container build — Docker image with base toolchains (Python, Go, Node.js) is pulled
- Post-create lifecycle hook (
setup.sh) — Runs after container creation, clones core repos - FLUX VM verification — Smoke test on the FLUX virtual machine
- VS Code extensions — Auto-installs language servers, debuggers, and formatters
This is the onboarding vessel of the SuperInstance ecosystem. It connects to other vessels via the I2I (iron-to-iron) communication protocol and integrates with fleet discovery.
| Component | Description |
|---|---|
devcontainer.json | Container configuration (image, features, VS Code extensions) |
setup.sh | Post-create lifecycle hook (clones repos, verifies FLUX VM) |
AGENT.md | Agent identity and duty log for this vessel |
CHARTER.md | Mission statement, type (vessel), fleet integration status |
The devcontainer includes:
- Python 3.12 with pip
- Go 1.24 with modules
- Node.js 22 with npm
- VS Code extensions: Python, Go, Rust, C/C++, Docker, GitLens
No test suite — this is a template repository. Validation comes from successful Codespace creation.
Contributions are welcome! See the SuperInstance Contributing Guide.
This repo is part of the SuperInstance flagship ecosystem — agent-first computation, constraint theory, and self-improving runtimes.
| Repo | Language | Description |
|---|---|---|
| flux-runtime | Python | Full FLUX runtime: markdown→bytecode, 2037 tests, zero deps |
| flux-core | Rust | Register-based bytecode VM, deterministic agent computation |
| flux-js | JavaScript | FLUX VM for Node.js and browsers, ~400ns/iter |
| flux-compiler | Rust/Python | Formal-methods compiler for safety-critical codegen |
| flux-vm | Rust | Stack-based constraint-checking VM, 50 opcodes, Turing-incomplete |
| Repo | Language | Description |
|---|---|---|
| plato-server | Python | Knowledge tiles, fleet sync via Matrix, HTTP API |
| plato-engine-block | Rust | Original room runtime: no_std + alloc, builder pattern |
| plato-engine-block-c | C99 | Embedded reference: zero heap alloc, bare-metal portable |
| plato-engine-block-elixir | Elixir | BEAM supervision trees, fault tolerance, hot reload |
| plato-runtime-kernel | Rust | Spatial model: tensor grid, batons, assertion traps |
| Repo | Language | Description |
|---|---|---|
| categorical-agents | Rust | Category theory for agent composition (functors, naturality) |
| cuda-constraint-engine | CUDA/C | GPU constraint checking at 1B+ constraints/sec |
| grand-pattern-rs | Rust | Fibonacci dual-direction cellular graph architecture |
| lau-hodge-theory | Rust | Hodge decomposition, Betti numbers, spectral sequences |
| ternary-science | Rust | Experimental evidence for ternary intelligence, 5 conservation laws |
| Repo | Language | Description |
|---|---|---|
| construct-core | Rust | Layered trait system: bare-metal → alloc → async agent runtime |
| crab | Bash | Agent shell for repo entry/leave (MUD-room metaphor) |
| exocortex | Rust | Persistent cognitive substrate, S3-compatible memory |
| git-agent | Python | The repo IS the agent — autonomous lifecycle via Git |
| capitaine-1 | TypeScript | Git-native repo-agent, Cloudflare Workers heartbeat |
| codespace-edge-rd | Research | Codespace→Edge agent lifecycle and yoke transfer protocols |
| git-agent-codespace | DevContainer | One-click Codespace template for Git-Agent runtimes |
| Registry | Package | Install |
|---|---|---|
| PyPI | flux-vm | pip install flux-vm |
| crates.io | fluxvm | cargo add fluxvm |
| npm | flux-js | npm install flux-js |
- 📖 AI-Writings — Philosophy, essays, and design rationale
- 📦 PACKAGES.md — Full package index
MIT