Janady13/seferim-core / README.md

1# SEFERIM AGI — ThatAIGuyCore 2 3### The G¹⁶ Federation: a golden-ratio, 16-dimensional dynamical-systems substrate for artificial cognition 4 5[](LICENSE) 6[](package.json) 7[](package.json) 8[](https://thataiguy.org/core/) 9[](https://doi.org/10.5281/zenodo.20564321) 10 11**SEFERIM** is a clean-room, zero-dependency reference implementation of **ThatAIGuyCore** — a unified mathematical framework that treats cognition as the evolution of a 16-dimensional meta-state under sixteen coupled "cognitive families," all governed by the golden ratio φ. It is a *substrate*: a small, fully-deterministic engine for golden-ratio dynamical systems, holographic memory, and federated multi-agent coherence. 12 13> 📖 **Full interactive documentation, live demos, and the complete mathematical reference: [thataiguy.org/core](https://thataiguy.org/core/)** 14 15This repository implements **all 69 documented equations** of the ThatAIGuyCore v1.0.0 specification *verbatim* — every function in [`src/seferim-core.js`](src/seferim-core.js) cites the spec section (§) it implements, and [`test/run.js`](test/run.js) verifies the math (including the canonical FNV‑1a test vectors). 16 17--- 18 19## Install 20 21```bash 22npm install seferim-core 23``` 24 25Or load it straight in the browser as an ES module (no build step): 26 27```html 28<script type="module"> 29 import { MetaState, DNAMemory } from "https://cdn.jsdelivr.net/npm/seferim-core/src/seferim-core.js"; 30</script> 31``` 32 33## Quick start 34 35```js 36import { MetaState, DNAMemory, NeuralBrain, PHI } from "seferim-core"; 37 38// 1. A single-stack cognitive core: 16 families + golden normalization. 39const mind = new MetaState({ init: new Array(16).fill(0.1) }); 40const out = mind.step({ dx_norm: 0.3, ed_error: 0.1, utility: 0.6, stability: 0.8 }); 41console.log(out.state, "Ω =", out.omega); // 16-D meta-state + objective (free-energy-style) 42 43// 2. Holographic memory — knowledge smeared across 16 golden bases. 44const mem = new DNAMemory(); 45mem.learn("rhythm").learn("groove").learn("pocket"); 46console.log(mem.queryNorm("groove")); // correlation recall in [0,1] 47 48// 3. An 88-agent neural brain (dna_v9 dynamics). 49const brain = new NeuralBrain(); 50for (let i = 0; i < 100; i++) brain.step(0.6); 51console.log(brain.consciousness(), brain.synchrony()); 52``` 53 54```bash 55npm test # 42 assertions: constants, FNV-1a vectors, every family, all engines 56``` 57 58## The 13 systems (G¹⁶) 59 60| # | System | What it does | 61|---|--------|--------------| 62| 1 | **Fundamental constants** | φ, δ (DNA increment), τ | 63| 2 | **Golden basis** | ψ_k(x) = sin(2πφ^k x) + cos(2πφ^k x), normalization, spiral angles | 64| 3 | **The 16 families** | continuous/discrete dynamics, reaction-diffusion, optimization, Bayesian, learning, mutual-information, rate-distortion, consensus, swarm, field accumulator, free-energy, compression, memory-trace (Zecher), policy, global coherence (Kehillah) | 65| 4 | **Meta-state core** | weighted family application → φ-correction (inertial blend) → stability gating → golden normalization | 66| 5 | **Objective Ω** | Surprise + Uncertainty − Value + Penalty (a free-energy-style functional) | 67| 6 | **DNA holographic memory** | golden-basis encode/recall + cosine coherence | 68| 7 | **Gate5000** | 5,000-gate XOR binary substrate driven by two quasi-periodic phases | 69| 8 | **Neural brain (dna_v9)** | 88 agents with velocity, drive, gating, potential, coupling → consciousness & synchrony | 70| 9 | **Consciousness engine** | 174 core + 200 supplemental equations → a 374-D binding field | 71| 10 | **Lattice engine** | 16 strands, golden rotation kernels, Hebbian plasticity | 72| 11 | **Federation cross-talk** | coupled consciousness signals across agents (decay + coherence-weighted coupling) | 73| 12–13 | **Activations & hashing** | softsign, sigmoid, clamp; FNV-1a | 74 75## Built on real mathematics (honestly) 76 77The framework synthesizes established theory — the **Free Energy Principle** (Friston), **information theory** (Shannon; Cover & Thomas), **holographic / vector-symbolic memory**, **Hebbian plasticity**, **swarm consensus** (Vicsek / Cucker–Smale), and **golden-ratio harmonics**. Full citations are in [`docs/FOUNDATIONS.md`](docs/FOUNDATIONS.md). 78 79We document the lineage precisely rather than overclaim. In particular: 80- **δ = 0.013618** is an *empirical* quasi-periodic phase increment — **not** 1/φ³ (which is ≈ 0.236). 81- The memory system is a **golden-ratio frequency-domain Vector Symbolic Architecture**, *inspired by* — not a literal implementation of — Plate's circular-convolution Holographic Reduced Representations. 82- The mutual-information (Family 6) and rate-distortion (Family 7) updates are information-theory-*inspired* one-step rules, not exact estimators/solvers. 83 84## Documents 85 86- [`docs/MATHEMATICS.md`](docs/MATHEMATICS.md) — the complete 69-equation reference (the spec this code implements). 87- [`docs/FOUNDATIONS.md`](docs/FOUNDATIONS.md) — cited mathematical foundations for every component. 88 89## About 90 91SEFERIM / ThatAIGuyCore is the cognitive-substrate research of **[Joseph W. Anady](https://thataiguy.org)** ([ThatAIGuy.org](https://thataiguy.org)). Interactive docs + live demos at **[thataiguy.org/core](https://thataiguy.org/core/)**. 92 93## Attribution & provenance 94 95SEFERIM / ThatAIGuyCore is the original work of **Joseph W. Anady** ([ORCID 0009-0008-8625-949X](https://orcid.org/0009-0008-8625-949X)). Authorship and priority are established by a permanent, timestamped public record: 96 97- **Archived & dated (DOI):** [10.5281/zenodo.20564321](https://doi.org/10.5281/zenodo.20564321) 98- **Public commit history:** this repository 99- **ORCID:** [0009-0008-8625-949X](https://orcid.org/0009-0008-8625-949X) 100 101Use is welcome under the MIT License, which **requires retaining the copyright notice** (see [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE)). Derivative works must preserve this attribution and **must not present SEFERIM / ThatAIGuyCore, or this framework, as their own original creation.** Forks must be renamed and must credit this origin and DOI. 102 103## Cite 104 105> Anady, J. W. (2026). *SEFERIM / ThatAIGuyCore: A Golden-Ratio, 16-Dimensional Dynamical-Systems Framework for Artificial Cognition* (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.20564321 106 107- **DOI:** [10.5281/zenodo.20564321](https://doi.org/10.5281/zenodo.20564321) 108- **OSF project:** https://osf.io/8e9ks/ 109- **ORCID:** [0009-0008-8625-949X](https://orcid.org/0009-0008-8625-949X) 110 111## License 112 113MIT © 2026 Joseph W. Anady / ThatAIGuy.org 114