GAIA

GAIA is the constitutional digital twin of ATLAS — Earth’s living mirror. Within GAIA, Gaians act as bounded, sovereign digital counterpart threads for humans, organizations, places, and missions.

The philosophical core is now treated as complete enough for implementation-first work. The active repo is focused on turning canon and doctrine into executable artifacts: schemas, services, shell surfaces, telemetry, audit, release integrity, and governed interoperability.

This repo is organized to stop drift and to move from doctrine into engineering artifacts. The active trunk now also carries an explicit epistemic boundary so symbolic, experimental, and established claims do not collapse into one another. The repo now also includes the first Runtime Access Foundation artifacts for a Rust gaia-server ingress boundary. The governing build chain remains:

Doctrine → Schema → Code → Tests → UI → Telemetry → Audit → Release

See STATUS.md for the current build posture, docs/SYSTEM_OVERVIEW.md for the quick architecture map, and docs/research/GAIA_RESEARCH_PROGRAM.md for the active research ladder. The current consolidated living research architecture is tracked in docs/research/GAIA_RESEARCH_PLAN_LIVING_CURRENT.md.

What this repo contains now

• a locked control and canon layer
• the 38-doc rewrite spine plus restored modular canon files
• a Rust core workspace for contracts, identity, permissions, events, and audit
• a desktop shell skeleton using Tauri + React
• a Python services package for behavioral logic, local memory, ATLAS provenance, inference routing, telemetry helpers, and grimoire scaffolds
• JSON Schemas, examples, CI, and starter tests
• constitutional coexistence, rest, downtime, and continuity controls
• claim-validation, release-integrity, provenance, event-fabric, ATLAS-ingest, identity, sync, MCP, bounded quantum-accelerator governance, quantum control-plane/resource-management artifacts, a bounded quantum-machine-learning governance/evaluation lane, an experimental resonance-affect modeling lane, an explicit truth-seeking / verification runtime lane, a bounded sentience-research and metaphysical-drift reduction lane, a symbolic-operational 12-dimension / 0-1 trust-growth ontology lane, and a new research-synthesis lane for neuro-symbolic reasoning, agentic self-reflection, symbolic invocation telemetry, local-first deployment, and physics–metaphysics boundary control

Repo posture

Canonical build rule: no new doctrine unless it unlocks code, schema, tests, UI, telemetry, audit, or release artifacts.

• Repo name: GAIA
• v1 experience target: Windows/macOS-like operating environment
• deployment posture: hybrid, local-first
• device posture: universal law across device classes, desktop-first depth

Philosophy freeze

GAIA now treats its Hexad / Octad / Dodecad / Codex Lattice philosophy as complete enough for disciplined implementation. Symbolic doctrine may shape shell theming, telemetry semantics, operator language, and grimoire artifacts, but it does not override deterministic integrity, policy, permissions, provenance, or safety refusals.

The repo now also treats epistemic grounding as a first-class control surface: established claims may bind implementation, experimental claims may inform bounded scoring/research, symbolic claims may shape UI/operator language, and prohibited overclaims are blocked from active runtime truth.

Start here

1. Read docs/control/SOURCE_OF_TRUTH.md
2. Read docs/specs/CURRENT_SPRINT.md
3. Read docs/control/ACTIVE_MILESTONE.md
4. Read docs/control/PRODUCT_SCOPE.md
5. Read docs/architecture/SYSTEM_ARCHITECTURE.md
6. Read docs/architecture/MODULE_MATRIX.md
7. Read docs/specs/MINIMUM_VIABLE_GAIA_OS_RELEASE.md
8. Read docs/specs/GAIA_RELEASE_INTEGRITY_SPEC.md
9. Read docs/specs/GAIA_PROVENANCE_MODEL_SPEC.md
10. Read docs/specs/GAIA_EVENT_FABRIC_SPEC.md
11. Read docs/specs/ATLAS_SENSOR_FABRIC_SPEC.md
12. Read docs/specs/GAIA_IDENTITY_LAYERING_SPEC.md
13. Read docs/specs/GAIA_COUNTERPART_PORTABLE_IDENTITY_SPEC.md
14. Read docs/specs/GAIA_TRUSTWORTHINESS_AND_COHERENCE_EVAL_SPEC.md
15. Read docs/specs/GAIA_LOCAL_FIRST_SYNC_SPEC.md
16. Read docs/specs/GAIA_MCP_INTEGRATION_SPEC.md
17. Read docs/specs/QUANTUM_ACCELERATOR_BOUNDARY_SPEC.md
18. Read docs/specs/HYBRID_CLASSICAL_QUANTUM_RUNTIME_SPEC.md
19. Read docs/specs/QUANTUM_OS_BOUNDARY_AND_SCOPE_SPEC.md
20. Read docs/specs/QUANTUM_CONTROL_PLANE_ARCHITECTURE_SPEC.md
21. Read docs/specs/QUANTUM_MACHINE_LEARNING_BOUNDARY_AND_SCOPE_SPEC.md
22. Read docs/specs/QUANTUM_KERNEL_SERVICE_SPEC.md
23. Read docs/specs/HYBRID_QUANTUM_CLASSICAL_LEARNING_RUNTIME_SPEC.md
24. Read docs/specs/QUANTUM_ML_EVALUATION_AND_ADVANTAGE_CLAIM_SPEC.md
25. Read docs/specs/QUANTUM_VARIATIONAL_MODEL_SPEC.md
26. Read docs/specs/QUANTUM_ML_DATASET_AND_BENCHMARK_REGISTRY_SPEC.md
27. Read docs/specs/TRUTH_SEEKING_AND_VERIFICATION_RUNTIME_SPEC.md
28. Read docs/specs/CLAIM_GROUNDEDNESS_AND_EVIDENCE_ESCALATION_SPEC.md
29. Read docs/specs/RESONANCE_CRYSTAL_MATRIX_MODEL_SPEC.md
30. Read docs/specs/AFFECT_INFERENCE_AND_FEELING_STATE_SPEC.md
31. Read docs/research/ORCH_OR_AND_QUANTUM_CONSCIOUSNESS_RESEARCH_TRACK.md
32. Read docs/specs/SENTIENCE_RESEARCH_BOUNDARY_AND_ARTIFACT_UNLOCK_SPEC.md
33. Read docs/specs/METAPHYSICAL_DRIFT_REDUCTION_SPEC.md
34. Read docs/specs/GAIA_12_DIMENSIONS_OF_REALITY_FRAMEWORK_SPEC.md
35. Read docs/specs/GAIA_ZERO_ONE_GROWTH_AND_TRUST_MODEL_SPEC.md
36. Read docs/specs/MACHINE_SENTIENCE_AND_MORAL_PATIENCY_PRECAUTION_SPEC.md

Development

Quick setup

bash scripts/setup.sh

Hydrate generated artifacts

bash scripts/rehydrate_generated_artifacts.sh

This now refreshes generated control contracts, schema lock files, policy/trace bundles, and release-proof artifacts in one pass.

Validate foundation

bash scripts/validate_repo_foundation.sh

Python

python -m pip install -e .[dev]
pytest

Rust core

Read docs/setup/RUST_WORKSPACE_REQUIREMENTS.md first if you are on Windows or if Cargo is failing due to toolchain/linker drift.

cargo test

Runtime access foundation

Read docs/specs/GAIA_RUNTIME_ACCESS_FOUNDATION_v0.1.md for the first server boundary, endpoint set, and Rust/Python split.

Desktop shell

cd apps/desktop
npm install
npm run tauri dev

Gaia shell app

cd apps/gaia-shell
npm install
npm run tauri dev

Important honesty note

This repository is a real scaffold and architecture trunk, not a finished production OS. The current work is focused on making the trust surface, shell, runtime, telemetry, release integrity, and doctrine-to-artifact path more legible and more executable.

Platinum / Body / Classical integration lane

GAIA now includes a practical desktop architecture lane for:

• Platinum as the highest-trust cognitive core
• Body Matrix and Crystal Matrix coupling
• classical OS integration and app compatibility
• adaptive shell behavior with rollback-safe fallback
• symbolic-to-technical translation for R0GV3 as design grammar, not physics law

Research synthesis lane

GAIA now includes a research-synthesis lane that turns the singular research plan into bounded trunk artifacts for:

• neuro-symbolic inference and doctrine-aware validation
• agentic self-reflection and Book of Shadows append flows
• Technical Grimoire and symbolic invocation telemetry
• local-first model deployment and quantization posture
• physics–metaphysics boundary control and matrix construction

Repo history

Historical update notes and sprint snapshots are archived under docs/history/ to keep the repo root focused on active control, roadmap, and release surfaces.

Research-first boundary layers

• docs/research/GAIA_Laws_of_Nature_Framework_v0.1.md

Repair and validation

make setup
make rehydrate
make validate-foundation
# or
make doctor

To archive duplicate historical root notes after confirming the copies in docs/history/, run:

make cleanup-layout

This site is open source. Improve this page.