🌌 sim-universe

Sim-Universe — virtual-universe runtime · toy lattice-model substrate at cosmological scale · 11 modules · QRNG-anchored entropy

virtual-universe · toy-lattice · τ-clock · multiverse-interferometer · QPU-bridge · ouroboros-QRNG · Bostrom-test · Gödel-Q-mutator

---

Toy lattice-model simulation substrate with quantum-RNG entropy injection. 11 modules across τ-clock evolution, multiverse interferometry, QPU bridge, Bostrom test harness, Gödel-Q mutator, and ouroboros QRNG perturbation. Forensic verdict (2026-04-27): EXISTS_RUNNABLE — ~4800 LoC sim core, ~17.8k LoC total upstream; 300-tick mini_world demo evidenced 2026-04-16.

Note

Distribution: GitHub canonical at https://github.com/dancinlab/sim-universe. CLI tooling installed via hx install sim-universe from the hexa-lang registry, or git clone directly. (HF Hub mirror retired 2026-05-04: HF Hub is designed for ML model weights / datasets; CLI tooling distribution is GitHub-canonical.)

---

What is sim-universe?

sim-universe is a virtual-universe runtime that lets you experiment with simulation-hypothesis-flavored physics on a laptop without renting QPU time. It combines:

1. anu_time τ-clock — Lorentz-metric scalar-field lattice with topology evolution and empirical anchor (300-tick mini_world canonical run evidence).
2. multiverse interferometer — KS-test + mutual-information higher-order correlator across M parallel mini-worlds (Phase 1 scale-up: M=15, T=500).
3. QPU bridge — VQE-H2 demo + ANU noise-model adapter (delegates to real-QPU vendors when API keys present; classical-simulator fallback).
4. ouroboros QRNG — quantum-RNG perturbation pipeline (baseline / shadow / comparison) with 4-tier ANU fallback (paid → keyed → legacy → urandom).
5. Bostrom test harness — anu_collector for simulation-hypothesis pre-registered statistical tests (Phase 1 scaffold).
6. Gödel-Q mutator — self-rewriting hexa AST harness with verify-gate

The name reflects the Bostrom-flavored simulation framing — toy lattice universes evolved against a QRNG-anchored entropy budget. This is NOT lattice QCD, NOT Einstein-equation evolution, NOT N-body cosmology, NOT Standard-Model physics. See Caveats for full honesty disclosure.

---

Architecture

                        ┌─────────────────────────────────────┐
                        │         sim-universe CLI            │
                        │      (cli/sim-universe.hexa)        │
                        │  status anu multiverse qrng bostrom │
                        │           godel selftest            │
                        └─────────────────┬───────────────────┘
                                          │
            ┌─────────────────────────────┼──────────────────────────────┐
            │                             │                              │
            ▼                             ▼                              ▼
   ┌────────────────┐          ┌────────────────────┐         ┌──────────────────┐
   │   Tier-A       │          │      Tier-A2       │         │     Tier-B       │
   │   simulators   │          │  RNG / analytics   │         │  sim-adjacent    │
   ├────────────────┤          ├────────────────────┤         ├──────────────────┤
   │ anu_time       │          │ ouroboros_qrng     │         │ sr_harness       │
   │  └ mini_world  │          │  └ baseline        │         │ bostrom_test     │
   │  └ τ-clock     │          │  └ shadow          │         │ weave  (PY-only) │
   │  └ Lorentz     │          │  └ perturbation    │         └────────┬─────────┘
   │ multiverse     │          │ atlas_anu_corr     │                  │
   │  └ interfer.   │          │ anu_stream         │                  │
   │  └ KS / MI     │          │ godel_q (mutator)  │                  │
   │ qpu_bridge     │          └─────────┬──────────┘                  │
   │  └ VQE-H2      │                    │                             │
   │  └ ANU noise   │                    ▼                             │
   └────────┬───────┘          ┌────────────────────┐                  │
            │                  │    ANU QRNG        │                  │
            │                  │  4-tier fallback   │                  │
            │                  │ paid → keyed →     │                  │
            │                  │ legacy → urandom   │                  │
            │                  └─────────┬──────────┘                  │
            │                            │                             │
            └────────────────────────────┼─────────────────────────────┘
                                         │
                                         ▼
                              ┌──────────────────────┐
                              │  sim_agent surface   │ ← importable lib entry
                              │ (registry + router)  │
                              └──────────────────────┘

opted out via .own N namespace). Tier-A modules carry the forensic EXISTS_RUNNABLE verdict.

---

Install

# 1. Install hexa-lang (gives you `hexa` + `hx` package manager)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/dancinlab/hexa-lang/main/install.sh)"

# 2. Install sim-universe
hx install sim-universe

Run

sim-universe status           # module inventory + tier table + caveats
sim-universe anu              # anu_time τ-clock mini_world demo  [Tier-A]
sim-universe multiverse       # multiverse interferometer + KS    [Tier-A]
sim-universe qrng             # ouroboros QRNG perturbation       [Tier-A2]
sim-universe bostrom          # Bostrom test (anu_collector)      [Tier-B]
sim-universe godel            # Gödel-Q mutator bootstrap         [Tier-A2]
sim-universe selftest         # Tier-A smoke pass

---

Module Inventory

Tier-A: runnable simulators (forensic 2026-04-27 verified)

Module	Files	Description
anu_time	11	τ-clock + mini_world + Lorentz metric + empirical anchor
multiverse	11	interferometer + KS-test + higher-order MI (triple/quad)
qpu_bridge	2	VQE-H2 demo + ANU noise-model adapter

Tier-A2: supporting (analytical + RNG infrastructure)

Module	Files	Description
atlas_anu_corr	5	ATLAS xcorr engine + null baseline + analyze
anu_stream	3	stream_daemon + chacha20 + client_example
ouroboros_qrng	4	baseline + shadow + qrng_perturbation + comparison
godel_q	2	Gödel-Q mutator + bootstrap (verify-gated AST mutations)

Tier-B: sim-adjacent harnesses

Module	Files	Description
sr_harness	3	sr_inject + demo_ouroboros_sr
bostrom_test	1	anu_collector (Bostrom test pre-registered statistics)
weave	2	cage-assembly Bayesian audit (PYTHON-only opt-out)

Surface

Module	Files	Description
sim_agent	4	sim_main + registry + router + source (importable lib entry)

Total: 11 modules, 80 files, ~15.5k LoC (.py + .hexa). Forensic core (upstream_sim_loc): 4,800 LoC. Forensic total upstream: 17,831 LoC (nexus/sim_bridge/ + nexus/core/sim/).

---

Forensic Verdict

Source forensic doc: nexus/state/sim_module_forensic_2026-04-27.md

• Verdict: EXISTS_RUNNABLE
• Canonical run evidence: nexus/sim_bridge/anu_time/runs/demo_300/log.jsonl (300 ticks, 2026-04-16)
• Roadmap anchor: nexus/.roadmap.sim + anima/.roadmap.sim sim.cond.1
• N-substrate anchor: anima/docs/n_substrate_consciousness_roadmap_2026_05_01.md §11.1 (N-9 / N-10 nodes)

---

Honesty disclosure — these caveats are returned by every CLI subcommand that prints _print_caveats() (status, selftest):

1. Honest scope: toy lattice models with QRNG entropy injection — NOT lattice QCD, NOT Einstein-equation evolution, NOT N-body cosmology, NOT Standard-Model physics. Class: Bostrom-flavored simulation framing. ~4800 LoC time-evolution code; do not extrapolate to real-physics regimes.
2. CLI surface limited: 7 subcommands expose ~core 12% of sim-universe modules (per-module advanced flags reachable only via direct hexa run of the module .hexa file).
3. Live ANU API requires SIM_UNIVERSE_ANU_KEY env (T1.b free 100 req/min keyed tier); without key → T1.a 1 req/min legacy → urandom fallback. Mock urandom path always available; reproducibility caveat applies (urandom is non-quantum).
4. weave subsystem is the SOLE python_bridge dep (numpy + scipy via weave disabled if numpy/scipy install fails (warn-only at install time).
5. Standalone-extraction caveat: nexus parent repo retains canonical roadmap (anima/.roadmap.sim + nexus/.roadmap.sim sim.cond.1); this standalone is the distribution mirror, not the upstream development tree. For ongoing roadmap state, consult upstream nexus.

Polish-cycle (v1.0.0) honest disclosures

The 1.0.0 polish landing (badges + GitHub release) adds four further honest C3 caveats — they sit alongside the 5 above:

1. GitHub-only distribution (HF Hub mirror retired 2026-05-04): HF Hub is designed for ML model weights / datasets, not CLI tooling. Maintenance burden (recurring token rotation failures) outweighed value. GitHub remains canonical; HF Hub stays canonical for model weights / datasets in the wider stack.
2. GitHub release deletion is friction-laden: once v1.0.0 is published it is technically deletable via gh release delete v1.0.0 --yes, but the tag retains its OID in any clone that fetched it; downstream consumers may carry phantom references. Treat each release tag as effectively immutable.
3. Public-repo maintenance burden: a public GitHub repository invites issue/PR triage cost (and discoverability of caveats by readers who skip §Caveats). Author has elected to absorb this cost; downstream consumers should not assume future SLA on issue response time.
4. API surface still maturing: 7 CLI subcommands cover the Tier-A demo surface; the underlying module APIs (<feature>/module/) have not been semver-frozen at 1.0.0 — minor versions may evolve module-internal call shapes. Pin to exact =1.0.0 in hexa.toml if downstream relies on specific module signatures.

---

Cost comparison vs alternative simulation tools

sim-universe is the only substrate-agnostic simulation runtime that combines τ-clock lattice evolution + multiverse statistical correlators + real-quantum entropy injection at $0 marginal cost on commodity CPUs. The landscape of reference points:

Approach	Per-run cost	What you get	What's missing vs sim-universe
sim-universe (this)	$0 Mac/Linux CPU	11 subsystems; QRNG-anchored toy lattice + multiverse interferometer + Bostrom harness + Gödel-Q mutator	— (this baseline)
Hand-rolled NumPy lattice	$0 (your time)	Whatever you build	No QRNG entropy, no multiverse correlator, no Bostrom-test pre-registration, no Gödel-Q AST verify-gate
Lattice QCD (e.g. Chroma, MILC)	hours-days HPC time (~$50-500/run on cloud HPC)	Real QCD action evolution	NOT comparable scope — sim-universe is toy lattice, not gauge theory
Cosmology N-body (Gadget-4, AREPO)	$100s-$1000s GPU time	Real N-body gravity	NOT comparable — sim-universe is Bostrom-flavored, not cosmology
Qiskit Aer state-vector (≤30 qubit)	$0 CPU	Quantum-circuit simulation	Single-modality; no τ-clock, no multiverse, no Bostrom harness — see sister project qmirror for that
IBM Heron / IonQ Forte real QPU	$1.60-2.30/sec QPU paygo	Real quantum hardware outcomes	Per-second metered; no lattice / multiverse / Bostrom layer

One-time calibration spend (closure cycle, total): $0 (urandom fallback path always usable; ANU live tiers T1.a/T1.b are free; T1.c paid ANU and real-QPU vendor paths are optional and gated behind explicit env flags). Recurring marginal cost for the default Tier-A demo surface is $0.

For real-quantum-grade work paired with sim-universe (CHSH Bell test, IIT 4.0 phi-star, NIST tier-1+ entropy, plus the v2.0 axes — process tomography / GHZ-Mermin / stabilizer / surface-code d=3 / chained-sequential CHSH), see the sister substrate qmirror v2.0.0 (closure 13/13 conds met) — designed to slot alongside sim-universe (different scope, complementary).

Sister substrates

• ⚛️ qmirror v2.0.0 — Quantum Mirror Substrate. ≤30 qubit Aer + ANU QRNG + 13/13 closure conds (8 v1 CHSH/IIT/NIST + 5 v2 tomography/GHZ-Mermin/stabilizer/surface-d3/CSCS).
• 🧬 hexa-bio v1.0.0 — Molecular Toolkit (WEAVE / NANOBOT / RIBOZYME / VIROCAPSID).
• 🛡️ honesty-monitor v1.0.0 — AI Honesty-Bit Falsifier (BT-AI2 contract).

---

Real-world consumers

sim-universe is consumed by two downstream projects in the dancinlab stack:

• nexus — discovery engine; treats sim-universe as the canonical simulation substrate via the upstream nexus/sim_bridge/ and nexus/core/sim/ directories (this standalone is the distribution mirror; nexus retains the canonical roadmap at nexus/.roadmap.sim).
• anima — meta-orchestration layer; uses sim-universe modules through the N-substrate consciousness roadmap (anima/docs/n_substrate_consciousness_roadmap_2026_05_01.md §11.1, N-9 / N-10 nodes) and the sim_agent importable lib entry.

Both consumers reference this repo by URL; neither forks the substrate in-tree.

---

Distribution (GitHub canonical)

sim-universe is distributed via GitHub as the canonical source:

• canonical: https://github.com/dancinlab/sim-universe

Install via hx install sim-universe (hexa-lang registry L23) or git clone.

HF Hub mirror retired 2026-05-04: HuggingFace Hub is designed for ML model weights and datasets, not CLI tooling. Maintenance burden outweighed value. GitHub remains canonical for the CLI; HF Hub stays canonical for model weights / datasets in the wider stack.

---

Cost Profile

Path	Cost
Mac local default (urandom fallback)	$0
Live ANU T1.a (legacy, 1 req/min)	$0
Live ANU T1.b (keyed, 100 req/min)	$0 (registration only)
multiverse Phase 1 full (M=15, T=500, 10 trials, ~5 min CPU)	$0
qpu_bridge real-QPU (vqe_h2_demo on classical sim)	$0
qpu_bridge real-QPU (live ionq/rigetti/ibm)	varies (vendor pricing)

---

Constraints

---

Repo layout

sim-universe/
├── README.md
├── LICENSE                       Apache-2.0
├── AGENTS.tape                   identity + governance (.tape v1.2)
├── CLAUDE.md                     symlink → AGENTS.tape
├── CHANGELOG.md
├── CITATION.cff
├── RELEASE_NOTES_v1.0.0.md
├── DESIGN_IDEAS_2026_05_12.md
├── TAPE-AUDIT.md                 .tape adoption audit ledger
├── hexa.toml                     hx package manifest
├── install.hexa                  install hook
├── cli/
│   └── sim-universe.hexa         CLI dispatcher (status · anu · multiverse · qrng · bostrom · godel · selftest)
├── anu_time/                     τ-clock + mini_world + Lorentz metric  [Tier-A]
├── multiverse/                   interferometer + KS-test + higher-order MI  [Tier-A]
├── qpu_bridge/                   VQE-H2 demo + ANU noise-model adapter  [Tier-A]
├── atlas_anu_corr/               ATLAS xcorr engine + null baseline  [Tier-A2]
├── anu_stream/                   stream daemon + chacha20 + client  [Tier-A2]
├── ouroboros_qrng/               QRNG perturbation (baseline · shadow · comparison)  [Tier-A2]
├── godel_q/                      Gödel-Q mutator + bootstrap (verify-gated)  [Tier-A2]
├── sr_harness/                   sr_inject + demo_ouroboros_sr  [Tier-B]
├── bostrom_test/                 anu_collector (pre-registered statistics)  [Tier-B]
├── weave/                        cage-assembly Bayesian audit (Python-only)  [Tier-B]
├── sim_agent/                    sim_main + registry + router + source (importable lib)
├── docs/
│   └── logo.svg                  sim-universe logo
├── examples/
├── tests/
├── tool/
└── state/                        runtime state (gitignored typically)

License

Apache-2.0 — see LICENSE.

Authors: 박민우 nerve011235@gmail.com

Provenance: extracted from nexus/sim_bridge/ + nexus/core/sim/ on 2026-05-04 under the anima_offrepo cycle (sim_universe_standalone_repo_2026_05_04 marker); polished to v1.0.0 release on 2026-05-04 under the sim_universe_polish_2026_05_04 cycle (badges + CHANGELOG + RELEASE_NOTES). HF Hub mirror retired 2026-05-04 (GitHub canonical for CLI tooling).

---

Status

• v1.0.0 (2026-05-04) — initial standalone release; forensic EXISTS_RUNNABLE verdict carried forward; CHANGELOG + RELEASE_NOTES committed.
• 2026-05-04 — hx install sim-universe registered as registry.tsv L23.
• 2026-05-04 — HF Hub mirror retired; GitHub canonical for CLI tooling.