██████╗ █████╗ ██████╗ ██╗ ██████╗ ██╗ ██╗
██╔════╝██╔══██╗██╔══██╗██║ ██╔══██╗╚██╗██╔╝
██║ ███████║██████╔╝██║ ██║ ██║ ╚███╔╝
██║ ██╔══██║██╔══██╗██║ ██║ ██║ ██╔██╗
╚██████╗██║ ██║██║ ██║███████╗ ██████╔╝██╔╝ ██╗
╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═╝ ╚═╝
A 2,114-Unit Neuromorphic Cognitive Architecture Operating in an Exact 30 Hz Physical Digital Twin
Key Capabilities • Architecture Mindmap • Cognitive Loop • 5-Stage Roadmap • Verification Ledger • Quickstart • Defense Guide
CARL-DX is a bio-inspired embodied cognitive robotic architecture operating inside a high-fidelity 3D digital twin powered by Google DeepMind's MuJoCo physics engine.
Standard modern robotics systems often rely on either handcoded heuristic state machines (which fail in unmapped terrains) or end-to-end deep reinforcement learning models (which act as black boxes, require millions of destructive trials, and catastrophically collapse when ground friction changes). Crucially, academic benchmarks frequently permit subtle simulation cheats by reading absolute global coordinates (qpos, geom_xpos) directly from physics memory.
CARL-DX establishes a zero-trust, unprivileged baseline:
- Zero Simulator Cheats: The cognitive decision pipeline is strictly isolated via AST static analysis; coordinates and raycasts are never accessed directly.
- Physical Grounding: CARL perceives the world strictly through unprivileged virtual serial telemetry (15 distance rays, 1-axis gyroscope, wheel encoders, tactile bumpers, and interoceptive battery drain).
-
Sub-Millisecond Reflexes: Low-level hazard reflexes resolve in
$< 0.2\text{ ms}$ , while high-level continuous trajectory optimization completes in$1.36\text{ ms}$ , safely within the 33.3 ms (30 Hz) real-time cycle budget.
| Organ / Mechanism | Biological Grounding | Technical Implementation | Certified Metric |
|---|---|---|---|
| Head Direction Attractor | Mammalian HD Cells (Taube 1998) | 64-unit continuous attractor ring network (CANN) with Mexican-hat synaptic inhibition. | Drift |
| Spatial Grid Torus | Medial Entorhinal Cortex (Moser 2005) | 1,024-unit 2D toroidal continuous attractor maintaining allocentric translational phase. | Homing return drift |
| Sensory Reservoir | Cortical Microcircuits (Maass 2002) | 1,026-unit recurrent Liquid State Machine (LSM) operating near criticality ( |
Real-time sensorimotor temporal projection |
| Kinematic Traction Observer | Mammalian Proprioception | Online wheel slip estimation ($\sigma = \frac{v_{\text{wheel}} - \hat{v}x}{v{\text{wheel}}}$) fusing IMU |
|
| Continuous Action Synthesis | Optimal Motor Control (Todorov 2002) | Model Predictive Path Integral (MPPI) evaluating |
Mean latency |
| Active Inference Deliberation | Free Energy Principle (Friston 2010) | Minimization of Expected Free Energy ( |
Autonomous reverse-pivot discovery in cul-de-sacs |
| Predictive World Model | Internal Forward Models (Ha 2018) | Decoupled grounded forward dynamics predicting 5 future sensory states. |
|
graph TD
subgraph SENSORY_LAYER ["1. Unprivileged Sensory Stream (Hardware Abstraction Layer)"]
S_Sonar["15x Sonar Distance Rays (360° Ring)"]
S_IMU["Vestibular Gyroscope (ω_gyro)"]
S_Enc["Wheel Encoders (v_wheel = r · (ω_L + ω_R)/2)"]
S_Acc["3-Axis Accelerometer (ax, ay, az)"]
S_Int["Interoceptive Battery & Touch Bumpers"]
end
subgraph REFLEX_STEM ["2. Subcortical Brainstem (< 0.5 ms Reaction)"]
R_Spike["Spiking Reflex Arc (LIF Threshold)"]
R_Slip["Grounded Kinematic Slip Detector (σ > 0.52)"]
R_Endo["Endocrine Allostasis (DA, NE, Cortisol, ACh)"]
R_Veto["Rotational Swept-Hull Collision Veto (R_swept = 0.1773m)"]
end
subgraph NEUROMORPHIC_CORE ["3. 2,114-Unit Neuromorphic Core"]
HD_Ring["64-HD Head Direction Ring Attractor (Mexican-Hat Invariant)"]
Grid_Torus["1,024-Unit 2D Toroidal Grid Attractor (Allocentric Space)"]
Reservoir["1,026-Unit Recurrent Liquid State Machine (LSM Reservoir)"]
World_Model["Decoupled Grounded Predictive World Model (R² = 0.9613)"]
Occ_Mem["Allocentric Raster Occupancy Memory (Grid-Indexed)"]
end
subgraph DELIBERATION ["4. Cortical Deliberation & Action Synthesis (30 Hz)"]
MPPI["Continuous MPPI Engine (M=128 Paths, H=15 Steps, 1.36 ms Latency)"]
Active_Inf["Active Inference: Expected Free Energy G(u) = Pragmatic + Epistemic"]
Top_Frontier["Topological Macro-Frontier Clustering & Egress Steering"]
end
subgraph ACTUATION ["5. Physical Digital Twin (MuJoCo Physics @ 500 Hz / 16 Substeps)"]
Motors["Differential Drive Actuators (u_L, u_R ∈ [-1.0, 1.0])"]
Chassis["Vessel Kinetic Chassis (Length=0.23m, Width=0.27m, Track=0.22m)"]
end
SENSORY_LAYER --> REFLEX_STEM
REFLEX_STEM --> NEUROMORPHIC_CORE
NEUROMORPHIC_CORE --> DELIBERATION
DELIBERATION --> Motors
Motors --> Chassis
Chassis -->|Real Kinematic Motion| SENSORY_LAYER
classDef hal fill:#0f172a,stroke:#38bdf8,stroke-width:2px,color:#f8fafc;
classDef reflex fill:#1e1b4b,stroke:#ef4444,stroke-width:2px,color:#f8fafc;
classDef neuro fill:#2e1065,stroke:#a855f7,stroke-width:2px,color:#f8fafc;
classDef delib fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#f8fafc;
classDef act fill:#451a03,stroke:#f59e0b,stroke-width:2px,color:#f8fafc;
class SENSORY_LAYER hal;
class REFLEX_STEM reflex;
class NEUROMORPHIC_CORE neuro;
class DELIBERATION delib;
class ACTUATION act;
CARL-DX operates on an exact
sequenceDiagram
autonumber
participant Phys as MuJoCo Digital Twin (500 Hz)
participant HAL as Virtual Serial HAL (Unprivileged)
participant Reflex as Reflex Arc & Slip Observer
participant CANN as 2,114-Unit CANN Attractor Core
participant MPPI as MPPI & Active Inference Engine
participant Motors as Differential Wheel Motors
Phys->>HAL: Step 16 physics substeps (16 x 0.002s = 0.0333s)
HAL->>Reflex: Stream 25-D unprivileged sensor packet
rect rgb(15, 23, 42)
note over Reflex: Check distance threshold (d < 0.15m) & traction slip (σ > 0.52)
alt Emergency Contact Detected
Reflex->>Motors: Override with reverse torque pulse (< 0.2 ms latency)
else Normal Deliberation
Reflex->>CANN: Update head-direction bump & grid displacement phase
CANN->>MPPI: Stream allocentric pose prior & occupancy memory
note over MPPI: Vectorized tensor sampling: M=128 rollouts x H=15 steps<br/>Score G = Pragmatic + Epistemic in 1.36 ms
MPPI->>Motors: Output optimal continuous velocities (u_L*, u_R*)
end
end
Motors->>Phys: Apply wheel motor torques to continuous physics simulation
The architecture was developed under a strict, immutable 6-stage sequential roadmap:
[STAGE 1] Sensorimotor Grounding & Body Babbling -> CERTIFIED ✅
[STAGE 2] Generative World & Self Modeling -> CERTIFIED ✅
[STAGE 3] Continuous Action Synthesis & Discovery -> CERTIFIED ✅
[STAGE 4] Autopoietic / Lifelong Synaptic Memory -> CERTIFIED ✅
[STAGE 5] Metacognition & Permission-Gated Tuning -> CERTIFIED ✅
[STAGE 6] Foreign Embodiment & Physical Prototype -> CERTIFIED ✅
Detailed Breakdown of Developmental Stages & Acceptance Gates
| Stage | Developmental Focus | Architectural Organ Grown | Pre-Registered Acceptance Gate | Empirical Status |
|---|---|---|---|---|
| Stage 1.0 | Body Babbling | 6-channel motor babbling | Anonymous topology discovery | PASSED ✅ |
| Stage 1.5 | Momentum Model | Linear forward dynamics model | Held-out prediction |
PASSED ✅ |
| Stage 1.6 | Kinematic Slip | Grounded traction discrepancy estimator | Ice detection |
PASSED ✅ |
| Stage 2.1A | Vestibular Homing | Unsupervised vestibular discovery | Drift |
PASSED ✅ |
| Stage 2.1B | CANN Core | 2,114-unit attractor network | Directional stability under sensory loss | PASSED ✅ |
| Stage 2.2 | Grounded World Model | Decoupled 5-step forward model | 7/7 Multi-step prediction gates ( |
PASSED ✅ |
| Stage 2.3 | Deliberation Veto | Prospective swept-cone clearance | 40/40 Challenge mazes cleared with 0.0% collision | PASSED ✅ |
| Stage 3.0 | Pipeline Hygiene | Code hygiene & sandbox isolation | 100% Clean AST static anti-cheat scan | PASSED ✅ |
| Stage 3.1 | CANN Causal Battery | Direct CANN-to-action coupling | Action divergence |
PASSED ✅ |
| Stage 3.2 | Spatial Memory | Counterfactual rollout fidelity |
|
PASSED ✅ |
| Stage 3.3 | Continuous MPPI | Vectorized trajectory synthesis | Latency p95 |
PASSED ✅ |
| Stage 3.4 | Active Inference | EFE minimization in cul-de-sacs | 100% Env 1 escape, 0% collisions in screening | PASSED ✅ |
| Stage 3.5 | Adaptation | Online friction & torque compensation | Adaptation to sudden |
PASSED ✅ |
| Stage 3.6 | Motor Synergies | HDC motor primitives & Physarum routing | Dead-end pruning via slime-mold diffusion | PASSED ✅ |
| Stage 3.7 | Multi-Modal Vision | Retinal |
50/50 escapes, 0/50 collisions, all 7 organs | PASSED ✅ |
| Stage 4.1 | R-STDP Plasticity | 3-factor eligibility traces & Turrigiano bounds |
|
PASSED ✅ |
| Stage 4.2 | HDC Episodic Memory | 2,048-D FHRR lossless multimodal binding | Cosine similarity query verified | PASSED ✅ |
| Stage 4.3 | SWR Sleep Replay | NREM reverse replay & SHY downscaling | Causal sleep advantage confirmed | PASSED ✅ |
| Stage 4.4 | GIS-901 Persistence | Cryptographic WAL & SHA-256 boot |
|
PASSED ✅ |
| Stage 5.1 | The Witness | 7-channel introspective telemetry | Zero false alarms in quiescent baseline | PASSED ✅ |
| Stage 5.2 | Causal Attribution | Pearl |
95.0% attribution accuracy across 4 families | PASSED ✅ |
| Stage 5.3 | Self-Modification | Triple-latch permission gating | Lipschitz-bounded adaptation, |
PASSED ✅ |
| Stage 5.4 | Adversarial Stress | 40-episode hazard battery |
|
PASSED ✅ |
| Stage 6.1 | Structural Plasticity | Dynamic graph topology modification | Dendritic spine turnover & sparse compilation | PASSED ✅ |
| Stage 6.2 | Foreign Embodiment | Brain injection into 4 unseen morphologies | Franka Panda pick-and-place, 100% pure contact | PASSED ✅ |
| Stage 6.3 | Heavy 3D Clutter | 52-obstacle arena, 4 chambers | 20/20 escapes (100%), 0.0% collisions | PASSED ✅ |
| Stage 6.4 | ESP32 Firmware | Q7 fixed-point on ₹2,150 BOM | 33.6 KB SRAM (< 11%), FreeRTOS dual-core | PASSED ✅ |
Every threshold, sample count, and evaluation matrix is pre-registered prior to testing:
====================================================================================================
CARL-DX MASTER ARCHITECTURAL VERIFICATION LEDGER
====================================================================================================
Stage Capability Tested Gate Criteria Empirical Result Status
----------------------------------------------------------------------------------------------------
Stage 1.0 6-Ch Sensorimotor Discovery Topology Recovery 100% Channel Mapping CERTIFIED ✅
Stage 1.5 Linear Forward Momentum Model Prediction R² >= 0.75 R² = 0.820 CERTIFIED ✅
Stage 1.6 Kinematic Traction Observer Ice Slip Detection 68.57% (mu=0.005) CERTIFIED ✅
Stage 2.1A Unsupervised Vestibular Homing Homing Drift <= 0.22 m Mean Error = 0.062 m CERTIFIED ✅
Stage 2.1B 2,114-Unit CANN Attractor Core Bump Stability under Slip Drift < 0.02 rad/s CERTIFIED ✅
Stage 2.2 Decoupled Grounded World Model Multi-Step Model Fidelity 7/7 Gates (R²=0.9613) CERTIFIED ✅
Stage 2.3 Prospective Trajectory Veto 40 Challenge Mazes 40/40 Cleared (0% Col) CERTIFIED ✅
Stage 3.0 AST Decision-Pipeline Hygiene Zero Simulator Leaks 100% AST Clean (0 Leaks) CERTIFIED ✅
Stage 3.1 CANN Multi-Objective Coupling Ablation Divergence Δu = 0.563, p < 10⁻¹⁶ CERTIFIED ✅
Stage 3.2 Non-LOS Spatial Memory Necessity Rollout Fidelity <=0.08m Error = 0.041 m CERTIFIED ✅
Stage 3.3 Continuous MPPI Synthesis p95 Latency <= 45.0 ms Mean 1.36ms, p95 2.14ms CERTIFIED ✅
Stage 3.4 Active Inference Cul-de-Sac Escape Screening Mazes 82% Escapes, Epistemic CERTIFIED ✅
Stage 3.5 Environmental Adaptation Friction μ=0.20 Drops 30/30 (100%) Escapes CERTIFIED ✅
Stage 3.6 Physarum Routing & Motor Synergies Cul-de-Sac Dead-End Ban 30/30 (100%), 0 Colls CERTIFIED ✅
Stage 3.7 Multi-Modal Vision & Integration 50-Ep Adversarial Frozen 50/50 (100%), 0 Colls CERTIFIED ✅
Stage 4.1 R-STDP Plasticity Turrigiano Homeostasis ΔW > 0, ‖W‖ ≤ 15.0 CERTIFIED ✅
Stage 4.2 2,048-D HDC Episodic Memory Lossless Binding & Query CosSim Recall Verified CERTIFIED ✅
Stage 4.3 NREM SWR Sleep Consolidation Causal Sleep Advantage Loop Prune + SHY Down CERTIFIED ✅
Stage 4.4 GIS-901 Atomic WAL Persistence SHA-256 Warm Boot ≤ 15 ms Boot Verified CERTIFIED ✅
Stage 5.1 The Witness Introspection 7-Channel Surprise Filter Zero False Alarms CERTIFIED ✅
Stage 5.2 Abductive Causal Attribution Pearl do(·) HDC Lookup 95.0% Accuracy (4 Fam) CERTIFIED ✅
Stage 5.3 Permission-Gated Self-Modification Triple-Latch + Lipschitz R² = 1.0 Homeostasis CERTIFIED ✅
Stage 5.4 Adversarial Stress Suite 40-Episode Hazard Battery +81.52% Recovery Adv CERTIFIED ✅
Stage 6.1 Structural Plasticity Dynamic Graph Topology Dendritic Turnover OK CERTIFIED ✅
Stage 6.2 Foreign Embodiment Transfer 4 Unseen Morphologies Franka Panda + 3 Tiers CERTIFIED ✅
Stage 6.3 Heavy 3D Clutter Arena 52 Obstacles, 4 Chambers 20/20 (100%), 0 Colls CERTIFIED ✅
Stage 6.4 ESP32 Sim-to-Real Firmware Q7 Fixed-Point ₹2,150 33.6 KB SRAM (< 11%) CERTIFIED ✅
====================================================================================================
CARL-DX enforces an architectural isolation invariant verified by continuous automated Abstract Syntax Tree (AST) static inspection (tests/test_stage3_ast_anti_cheat.py):
# The cognitive decision pipeline is forbidden from accessing simulator ground truth:
FORBIDDEN_ATTRIBUTES = {"qpos", "qvel", "qacc", "geom_xpos", "site_xpos", "mj_ray", "mj_step"}- Any reference to simulator coordinates, internal physics matrices, or raycasting primitives inside the cognitive loop triggers an immediate build failure.
- Physical state estimation must emerge strictly through the unprivileged virtual serial hardware boundary.
All operational constants are derived from first-principles mechanics and academic literature:
-
Homing Target Gate (
$0.22\text{ m}$ ): Matches the physical wheel-to-wheel track width ($0.22\text{ m}$ ) of the chassis (Siegwart & Nourbakhsh 2011). Landing within$0.22\text{ m}$ guarantees physical contact with charging dock terminals. -
Control Frequency (
$30\text{ Hz}$ /$33.3\text{ ms}$ ): MuJoCo integrates physics at$500\text{ Hz}$ ($dt = 0.002\text{ s}$ ). Grouping 16 substeps yields$16 \times 0.002\text{ s} = 0.0333\text{ s} = 30\text{ Hz}$ , matching mammalian motor/gamma rhythm cycles (Maass 2002). -
Lookahead Horizon (
$H = 15\text{ steps} = 0.45\text{ s}$ ): Derived from the mammalian immediate perceptual reaction horizon ($0.5\text{ s}$ , Todorov 2012). At cruising speed ($0.45\text{ m/s}$ ), CARL looks ahead$\approx 0.20\text{ m}$ , aligning with sonar divergence angles. -
MPPI Sample Count (
$M = 128$ ): Information-theoretic optimal distribution coverage for non-holonomic mobile drive (Williams et al. 2017), structured for L1 CPU cache vectorization. -
Critical Friction (
$\mu = 0.35$ ): Analytically derived from Coulomb's traction boundary at maximum acceleration:$$\mu_{\text{crit}} = \frac{a_{\text{max}}}{g} = \frac{3.5\text{ m/s}^2}{9.81\text{ m/s}^2} \approx 0.356$$ -
Emergency Reflex Distance (
$0.15\text{ m}$ ): Stopping distance ($6.25\text{ cm}$ ) + reaction distance ($1.7\text{ cm}$ ) + caster buffer ($7.0\text{ cm}$ )$\approx 15.0\text{ cm}$ .
d:\ebca/
├── carl_simulation.py # Primary 30 Hz closed-loop simulation entry point
├── carl_live_playground.py # Interactive 3D visualization & testing arena
├── CARL_PRESENTATION_COMPLETE_LAYMAN_GUIDE.md # 45-slide presentation & master viva defense guide
├── requirements.txt # Core dependencies
├── LICENSE # MIT License
├── README.md # Repository overview
│
├── brain/ # Neuromorphic Core & Cognitive Organs (AST-Quarantined)
│ ├── carl_autonomous_agent.py # Canonical unified organism on zero-copy agent bus
│ ├── carl_embodied_organism.py # Sensorimotor grounding & body kinematics
│ ├── carl_stage1_hal.py # Unprivileged virtual serial hardware abstraction
│ ├── carl_stage1_reservoir.py # 1,026-unit recurrent Liquid State Machine
│ ├── carl_stage2_hd_ring.py # 64-unit continuous attractor head-direction ring
│ ├── carl_stage2_grid_torus.py # 1,024-unit 2D toroidal grid cell attractor
│ ├── carl_stage2_integrated_brain.py # Unified 2,114-unit neuromorphic integration
│ ├── carl_stage2_2_world_model.py # Decoupled predictive forward dynamics (R²=0.9613)
│ ├── carl_stage2_2_r2_occupancy_memory.py # Allocentric raster occupancy memory
│ ├── carl_stage2_3_r1_deliberation.py # Prospective trajectory vetoing & swept-cone clearance
│ ├── carl_mppi_deliberation.py # Vectorized continuous MPPI action synthesizer
│ ├── carl_active_inference.py # Expected Free Energy minimization (G = Pragmatic + Epistemic)
│ ├── carl_endocrine.py # Neuromodulatory kinetics (DA, NE, 5-HT, ACh)
│ ├── carl_motor_synergies.py # 2,048-D HDC motor synergy clustering (Stage 3.6)
│ ├── carl_physarum.py # Physarum Hagen-Poiseuille topological routing (Stage 3.6)
│ ├── carl_vision.py # CarlVisionNet retinal 64×64 RGB (Stage 3.7)
│ ├── carl_stdp.py # 3-factor R-STDP plasticity (Stage 4.1)
│ ├── carl_hdc.py # 2,048-D FHRR holographic associative memory (Stage 4.2)
│ ├── carl_rem_sleep.py # NREM SWR reverse replay & sleep consolidation (Stage 4.3)
│ ├── carl_gis.py # GIS-901 WAL atomic persistence (Stage 4.4)
│ ├── carl_witness.py # "The Witness" metacognitive monitor (Stage 5)
│ ├── carl_structural_plasticity.py # Dynamic graph topology modification (Stage 6.1)
│ └── carl_reflex.py # Low-latency subcortical hazard reflex arc
│
├── world/ # MuJoCo Physics Digital Twin Environments
│ ├── vessel_kinetic.xml # Physical chassis model (2WD differential + dual casters)
│ ├── clean_arena.xml # Open exploration and babbling arena
│ ├── stage3_2_environments/ # 5 non-LOS spatial memory task geometries
│ ├── stage3_4_environments/ # Cul-de-sac and asymmetric T-junction challenge mazes
│ ├── stage6_embodiments/ # Foreign morphology XMLs (skid-steer, omni, manipulator)
│ ├── stage6_environments/ # Heavy 3D clutter arena (52 obstacles, 4 chambers)
│ └── downloaded_embodiments/ # DeepMind MuJoCo Menagerie Franka Emika Panda
│
├── tests/ # Pre-Registered Verification & Regression Suites
│ ├── test_stage1_gate5_suite.py # Stage 1 sensorimotor grounding regression
│ ├── test_stage3_ast_anti_cheat.py # Stage 3.0 AST static analyzer & SHA-256 gateway
│ ├── test_stage3_1R_cann_causal_battery.py # Stage 3.1 4-arm CANN causal battery
│ ├── test_stage3_2RA_trajectory_fidelity.py # Stage 3.2 rollout fidelity benchmark (≤ 0.08m)
│ ├── test_stage3_2RB_memory_necessity_battery.py # Stage 3.2 non-LOS spatial memory necessity
│ ├── run_stage3_5_complete_battery.py # Stage 3.5 physical perturbation battery
│ ├── run_stage3_7_complete_battery.py # Stage 3.7 50-episode adversarial acceptance
│ ├── run_stage4_1_complete_battery.py # Stage 4.1 R-STDP plasticity battery
│ ├── run_stage4_4_complete_battery.py # Stage 4.4 GIS-901 persistence battery
│ ├── run_stage5_integrated_organism_battery.py # Stage 5 master integrated 8-organ battery
│ ├── run_stage6_2_foreign_embodiment_battery.py # Stage 6.2 foreign embodiment transfer
│ ├── run_stage6_3_clutter_arena_battery.py # Stage 6.3 heavy 3D clutter arena
│ └── verify_carl_brain_authenticity_and_causal_necessity.py # Jury authenticity proof
│
├── firmware/ # ESP32 Sim-to-Real Physical Prototype (Stage 6.4)
│ ├── carl_esp32_firmware.c # Q7 fixed-point neuromorphic engine (FreeRTOS)
│ └── esp32_frugal_prototype_spec.md # ₹2,150 hardware BOM specification
│
├── docs/ # Master Documentation & Scientific Reports
│ ├── reports/ # Pre-registered milestone reports & scorecards
│ │ ├── stage1/ # Stage 1.0, 1.5, and 1.6 validation & audit reports
│ │ ├── stage2/ # Stage 2.0 to 2.3 specifications & council verdicts
│ │ ├── stage3/ # Stage 3.0 to 3.7 verification reports & telemetry
│ │ └── phase1_audits/ # Historical P1 protocol ledgers & receipts
│ ├── presentation/ # Defense slides, decks, and presentation guides
│ │ ├── decks/ # Active slide decks (310_Stage3_Updated_Final.pptx)
│ │ └── archive_decks/ # Historical presentations & layout iterations
│ ├── architecture/ # Architectural blueprints, cognitive specs & audits
│ └── textbook/ # Complete human textbook walkthrough volumes
│
├── tools/ # Utilities & Deck Automation Builders
│ └── presentation_builders/ # Automated PowerPoint deck generators & formatters
│
├── evidence/ # Empirical Telemetry, Figures & Experimental Proofs
│ ├── stage1/ through stage6/ # Per-stage scorecards, SHA-256 sidecars, figures
│ ├── master_cumulative/ # Cross-stage cumulative evaluation data
│ └── videos/ # Master MP4 demonstration and commute proofs
│
└── scratch/ # Temporary debug scripts and simulation logs
Clone the repository and install core dependencies:
git clone https://github.com/Manassadashiv/EBCA.git
cd EBCA
# Create and activate environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install dependencies
pip install -r requirements.txtLaunch the real-time interactive physics environment with live sensor ray rendering and chassis steering:
python carl_live_playground.pyExecute CARL's unified 30 Hz cognitive control cycle with continuous attractor navigation:
python carl_simulation.pyVerify the 86 core numerical unit tests:
pytest tests/test_endocrine.py tests/test_reservoir.py tests/test_grid_cells.py tests/test_physarum_and_omega.py tests/test_gis_and_memory.py -vVerify zero privileged simulator coordinate leakage in the decision loop:
pytest tests/test_stage3_ast_anti_cheat.py -vFor academic seminars, doctoral/master's defense committees, and viva presentations:
- Comprehensive Layman Guide:
CARL_PRESENTATION_COMPLETE_LAYMAN_GUIDE.mdcontains complete slide-by-slide scripts, real-world analogies, defense Q&A scripts, and theoretical derivations across all 45 presentation slides. - Master Presentation Deck:
docs/presentation/decks/310_Stage3_Updated_Final.pptx.
If you use CARL-DX or the EBCA framework in your research, please cite:
@article{ebca2026carldx,
title={CARL-DX: A Digital Twin Framework for Biologically Grounded Cognitive Robotic Systems Operating in Continuous Physical State Spaces},
author={Manas Sadashiv},
year={2026},
publisher={GitHub},
journal={GitHub Repository},
howpublished={\url{https://github.com/Manassadashiv/EBCA}}
}This project is licensed under the MIT License — see the LICENSE file for details.