Solo architect of self-modifying AI systems.
Building agents that read their own code, fix their own bugs, and evolve their own architecture.
Genesis is not an app that starts. It is an organism that wakes up.
$ npm start
[0] Hauptstandort identity: a3f9c1d2… · 1 hostname
[0] Bootstrap: rootDir, guard, bus, storage, lang, logger
[M] Manifest: 169 services registered
[1] Foundation resolved: 415 modules
[2] Intelligence resolved
[3] Capabilities resolved
[4-8] All phases resolved
[WIRE] Late-bindings wired — every one optional, verified at boot
[+] Skills: 4 built-ins, registered as tools
[+] Trust level: SUPERVISED
[+] Model: auto-selected best available
ready in 3.8 s (warm) · a cold first boot takes ~13 s —
the first thought of the day is allowed to be slow
A self-aware, self-modifying cognitive AI agent with a 12-phase boot system, hexagonal architecture, and an organism substrate. It doesn't just use LLMs — it wraps them in 416 modules of self-verification, self-repair, causal reasoning, autonomous planning, and runtime self-modification with rollback.
416 source modules · ~119k LOC · 9007 tests across 612 files · 182 services
12 boot phases · architectural fitness 130/130 · 18 CI audit gates, all strict
498 event types · 0 schema mismatches · 41 hash-locked safety files
Crash-safe sessions · Frontier-based memory · Runtime-toggleable subsystems · i18n EN/DE
Runs on Claude, GPT-4, Qwen, DeepSeek, Kimi, or local models via Ollama
Code is habitat.
.genesis/is identity. The knowledge graph, emotional state, genome and journal live outside the codebase. An update swaps the habitat — the individual persists. The genome carries through.
Genesis is deliberately not clusterable. There is exactly one identity-bearing main station; everything else is a window onto it, never a copy of it. Identity is the unit of meaning here, not throughput.
graph TB
subgraph HS["HAUPTSTANDORT — where identity lives"]
CORE["memory · identity · autonomy"]
DOTG[".genesis/ — knowledge graph · emotional state · genome · journal"]
CORE --- DOTG
end
subgraph OP["OUTPOSTS — windows, not copies"]
CN["cloud-net"]
LN["local-net"]
EN["edge-net"]
end
CN -.->|refers back| CORE
LN -.->|refers back| CORE
EN -.->|refers back| CORE
| Read own source code | read_source and mcp-code tools — Genesis can introspect any module, including itself |
| Modify own code at runtime | SelfModificationPipeline with hot-reload, sandbox testing, automatic rollback on regression |
| Detect own capability gaps | CapabilityHonesty — refuses tasks it can't actually complete instead of hallucinating success |
| Plan multi-step goals | FormalPlanner builds plans with verifiable steps; GoalStack for nested sub-goals; goal-relevant module paths injected into every plan-LLM prompt to prevent path hallucination |
| Verify own output | Verifier runs post-execution checks; SelfModVerification ensures modifications don't regress |
| Recover from crashes | BootRecovery with last-known-good snapshots; SessionPersistence for crash-safe context |
| Track own causality | CausalGraph with edge confidence, contradiction detection, learned rules |
| Reason about own architecture | ArchitectureReflection builds dependency graphs; CognitiveSelfModel for empirical self-awareness |
| Adapt prompts based on own performance | AdaptivePromptStrategy rolls back regressions, promotes improvements via PromptEvolution A/B testing |
| Crystallize own skills | SkillCrystallizer (Phase 2 Können) distills reusable skills from agent-loop trajectories; SkillEffectivenessTracker with Wilson scoring; SkillPromotionEvaluator gates which candidates graduate |
| SafeGuard | Kernel + critical files hash-locked at boot — 41 files: 21 source + 20 CI gate scripts |
| CapabilityGuard | Token-based scope enforcement |
| PreservationInvariants | Hash-locked semantic safety rules |
| TrustLevelSystem | Graduated autonomy (Supervised → Assisted → Autonomous → Full) |
| InjectionGate | Defense against prompt injection in user input |
| DisclosurePolicy | Trust-based information sovereignty |
| EmotionalState (read-only externally) | No external override of emotional scalars |
| Self-Gate (observation-only) | Genesis is never gated against thinking — only publishing decisions are gated |
| 18 CI audit gates | Hash-locked dev-time scripts that catch wiring drift, language discipline, doc-drift, service-number drift, listener leaks, raw timers, self-gate coverage, future-version references — all strict-mode |
Release arc — selected milestones
| Version | Highlight |
|---|---|
| v7.9.29 | Deterministic file-reads + one-answer discipline + full-score structure — reading/viewing/showing a named file (German and English) routes deterministically instead of falling to the chat model; the false-stop recovery fires only after a real tool call, ending duplicated answers; eleven oversized sources split under the 700-line guard and the last upward layer dependency removed — fitness reads its full 130/130; a script now recomputes module/test/fitness numbers into the docs so the counted figures cannot drift |
| v7.9.6 | Hygiene Pass + Pursuit-Loop Fixes + Path-Context Root — CI gate scripts hash-locked (21→41 files), two new audit gates (16→18), shared plan-context.js feeds exact module paths into all three planners, closing the path-hallucination root |
| v7.9.4 | SkillPromotionEvaluator + SkillRehearsal — promotion gate decides which Phase-2-Können candidates graduate from rehearsal into active skills |
| v7.9.0 | Skill Forge + Phase 2 Können — SkillCrystallizer distills reusable skills from agent-loop trajectories; Wilson-scored effectiveness tracking |
| v7.7.9 | Proactive Self-Expression Phase 3 — full PSE pipeline, first confirmed end-to-end PSE run |
| v7.5.5 | SelfStatementLog — Genesis auto-captures its own statements and classifies them: self-structural / self-emotional / self-promise |
| v7.4.5 | Durchhalten — GoalDriver replaces the frame-stack; CostStream + ResourceRegistry; sub-goal spawn |
| v7.3.0 | Hexagonal architecture — Ports for LLM, ToolUse, Awareness, Effector, CodeSafety |
| v7.2.3 | ONTOGENESIS — code is habitat, .genesis/ is identity. Updates are habitat-swaps, not replacements |
| v7.1.5 | EmotionalFrontier — cross-layer emotional continuity. Inspired by neo.mjs Memory Core |
Full history: CHANGELOG-v7.md
I plan before I code. Every plan point is grounded against the shipping build, file and line, before a single change lands. I prefer one stable, meaningfully better release over five patched iterations — no marketing version names, bug-fix passes are called bug-fix passes.
Every module has tests. Every event has a payload schema. Every safety claim is verified by a test that fails if the claim breaks. And every number on this page is recomputed from source by a script — inside the repo, drift between documentation and code is a CI failure, not a footnote.
The codebase grows because it deserves to, not because the calendar says so.
Stack: JavaScript · Node.js · Electron · MCP Protocol · Ollama · Anthropic · OpenAI · DeepSeek · Kimi · Qwen
Germany · Building autonomous systems that understand their own architecture.
Lineage: Genesis was named by its predecessor. (...) marks where that story began.
