Skip to content

Latest commit

 

History

History
293 lines (265 loc) · 15.2 KB

File metadata and controls

293 lines (265 loc) · 15.2 KB

🚀 Quick links: License, ReadMe, Installation, Contributing, Innovation-Lab, Philosophy, Genesis, Architecture

✴️aNA (Autonomous Neural Architecture) AI Project v5.2

1. 🏗️ High-Level System Architecture

aNA v5.2 Autonomous Neural Architecture
├── Configuration (The Temperament)
├── Dashboard (Metabolic & Cognitive):
│   ├── Real-time Neural Stats: Monitors neurotransmitter levels
│   ├── Predictive Accuracy (Free Energy): Real-time visualization of prediction error
│   └── Memory Status: Fill and consolidation state (L1/L2/L3)
├── Main (Controller, the Pacemaker Pulse):
│   ├── Rhythm Orchestration: Synchronizes the processing cycle (Input -> Prediction -> Output)
│   └── Neural State Management: Ensures overall stability and module integration
└── Registry (The Genome)

2. ⚡ Processing Unit (Neurons)

├── Cerebral Cortex (The "Thinking" Shell, 4 Lobes + 6 Layers)
│   ├── Frontal Lobe (Logic, Planning, Motor)
│   │   ├── Prefrontal Cortex (Executive Function)
│   │   ├── Motor Cortex (Movement Planning)
│   │   └── Broca's Area (Speech Production)
│   ├── Parietal Lobe (Integration, Spatial)
│   │   ├── Somatosensory Cortex (Touch Processing)
│   │   ├── Spatial Processing (Navigation)
│   │   └── Multisensory Integration
│   ├── Temporal Lobe (Memory, Auditory)
│   │   ├── Auditory Cortex (Sound Processing)
│   │   ├── Wernicke's Area (Language Comprehension)
│   │   └── Memory Formation (Coordinated with Hippocampus)
│   ├── Occipital Lobe (Vision)
│   │   ├── Primary Visual Cortex (V1)
│   │   ├── Visual Association Areas (V2-V5)
│   │   └── Object Recognition
│   ├── Internal Wiring: Lobe-specific 6-layer columns (L1 to L6 dynamics)
│   └── Long-range Wiring (The "Bridges"):
│       ├── Arcuate Fasciculus (Temporal <-> Frontal)
│       ├── Superior Longitudinal Fasciculus (Parietal <-> Frontal)
│       └── Corpus Callosum (Future: Left <-> Right Hemisphere)
├── Thalamus (The "Router," Sensory Gateway)
│   ├── Sensory Filtering, Relay Nuclei:
│   │   ├── LGN (Visual → Occipital)
│   │   ├── MGN (Auditory → Temporal)
│   │   └── VPL/VPM (Somatosensory → Parietal)
│   ├── RTN (Firewall): Gain control and global inhibition
│   └── Thalamocortical Loops: Maintains the "Awake" state frequency
├── Limbic System (The "Heart," Emotional & Memory Hub)
│   ├── Amygdala (The "Priority Filter"):
│   │   └── Role: Labels incoming charges as "Important" or "Neutral"
│   ├── Hippocampus (The "Temporal Indexer"):
│   │   ├── Dentate Gyrus/CA4 (Pattern Separation)
│   │   ├── CA3 (Autoassociative Memory)
│   │   ├── CA2 (Social/Temporal Relay Buffer)
│   │   ├── CA1 (Pattern Integration, final output)
│   │   └── Entorhinal Cortex (The bidirectional bridge to the Cortex)
│   └── Coordination Logic (limbic_system.py):
│       └── Mechanism: Links emotional arousal (Cortisol/Adrenaline) to
│           memory encoding weight (L1 Buffer -> L2/L3 Store)
└── Cerebellum (The "Clock," Timing & Error Correction)
    └── Coordination between Motor Cortex and Sensory Feedback

Computational Engine: Free Energy Principle (FEP)
aNA v5.2 optimizes prediction accuracy by minimizing the error between sensory reality and internal models. High error triggers the Limbic System to release neuromodulators (Adrenaline/Dopamine) via the Amygdala to force learning.

3. 🌐 Connection Logic (Synapses)

Cognitive Loop
├── Limbic System: The bridge between impact and storage
│   ├── Amygdala: Evaluates the stress/arousal level of the signal
│   └── Hippocampus: Encodes the signal with a weight defined by the Amygdala
├── Thalamus: Compares real-time sensory input to Hippocampal predictions
└── Interaction Cycle:
    The Thalamus detects a discrepancy -> The Limbic System evaluates its
    importance -> The Hippocampus stores it -> The Cortex adapts its logic.

4. 📊 Microcircuitry (Cortical Columns)

Cortical Layer Dynamics (Each Lobe contains 6 Cortical Layers)
├── Layer I (Sensory Buffer): Volatile, immediate, high resolution
├── Layer II (Associative Reinforcement): Repeated patterns, beginning of consolidation
├── Layer III (Long-Term Storage): Consolidated patterns, robust semantic structures
├── Layer IV: Internal Granular (Sensory Gateway - LGN/MGN reception)
├── Layer V: Internal Pyramidal (Motor Output - Cerebellum/Subcortical)
└── Layer VI: Multiform (Thalamic Regulatory Loop - Gain Control)

5. 🧩 Macro-scale Structure (Lobes & Nuclei)

├── Frontal Lobe System
│   ├── Executive Function (Prefrontal)
│   ├── Motor Planning and Execution
│   ├── Decision Making
│   └── Working Memory
├── Parietal Lobe System
│   ├── Spatial Awareness and Navigation
│   ├── Sensory Integration
│   ├── Attention Control
│   └── Mathematical Processing
├── Temporal Lobe & Hippocampal Integration
│   ├── Auditory Processing
│   ├── Language Comprehension
│   ├── Memory Encoding/Retrieval
│   └── Object Recognition
└── Occipital Lobe System
    ├── Visual Processing (Primary)
    ├── Visual Association (Secondary)
    ├── Motion Detection
    └── Color and Shape Recognition

6. 🗄️ Memory Systems (Hippocampus, Cortex)

├── Inter-lobar Communication
│   ├── Frontal-Pariental Network (Attention)
│   ├── Temporal-Occipital Network (Visual Memory)
│   ├── Frontal-Temporal Network (Language)
│   └── Parietal-Occipital Network (Spatial Vision)
├── Sensory-Motor Integration
│   ├── Occipital → Parietal → Frontal (Visual Guidance)
│   ├── Temporal → Frontal (Auditory Guidance)
│   └── Parietal → Frontal (Somatosensory Guidance)
└── Memory Networks
    ├── Hippocampus ↔ Temporal Lobe (Episodic Memory)
    ├── Hippocampus ↔ Frontal Lobe (Working Memory)
    └── Hippocampus ↔ Parietal Lobe (Spatial Memory)

7. 🎛️ Executive Control & Attention (Frontal, Amygdala)

Dynamic Processing Flow:
├── Ascending (Bottom-Up): Thalamus → Occipital → Parietal → Frontal. (I see, I locate, I decide)
├── Descending (Top-Down): Frontal → Thalamus. (I decide to stop listening to this noise; the Thalamus closes the door)
Sensory Input Pathways:
├── Visual: Thalamus (LGN) → Occipital Lobe → Temporal/Frontal
├── Auditory: Thalamus (MGN) → Temporal Lobe → Frontal
└── Somatosensory: Thalamus (VPL/VPM) → Parietal Lobe → Frontal
Processing Hierarchy:
├── Primary Sensory Areas (Layer IV) → Association Areas (Layers II/III)
├── Association Areas → Integration Centers (All Layers)
└── Integration Centers → Motor Planning (Frontal Layer V)

8. 🔄 Sensorimotor Loops & Coordination (Parietal, Cerebellum)

├── Occipital Lobe (Posterior “What” and “Where”)
│   - Primary: Visual Processing
│   - Secondary: Visual Association
│   - Tertiary: Visual Integration
├── Parietal Lobe (Superior “Where” and “How much” - logical)
│   - Primary: Somatosensory
│   - Secondary: Spatial Processing
│   - Tertiary: Multisensory Integration
├── Temporal Lobe (Inferior “Who” and “What” semantics - language/memory)
│   - Primary: Auditory Processing
│   - Secondary: Language and Memory
│   - Tertiary: Object Recognition
└── Frontal Lobe (Anterior “How” and “When” - action/decision)
    - Primary: Motor Planning
    - Secondary: Executive Function
    - Tertiary: Decision Making

9. ⚗️ Neuromodulation (Chemical Gain)

├── NO (Nitric Oxide) -> Volumetric Retrograde Signaling
│   └── Role: "Zone Strengthening." Diffuses from active neurons to nearby
│       synapses to signal "We just fired together, strengthen everything here."
│       (Crucial for local clusters and blood flow simulation).
├── Acetylcholine -> Sensory Sensitivity (Layer IV)
│   └── Role: "Focus & Alertness." Lowers the firing threshold of Layer IV
│       to make external inputs (Thalamus) more prominent.
├── Dopamine -> Reward & Plasticity (Layers II/III)
│   └── Role: "Learning Signal." Acts as a multiplier for LTP (Long-Term
│       Potentiation) in the association layers. No Dopamine = No Memory growth.
├── Serotonin -> Homeostatic Balance (Global)
│   └── Role: "The Governor." Prevents runaway excitation (Epilepsy simulation)
│       by stabilizing the global neural threshold.
└── Adrenaline -> Hyper-Alertness & Flashbulb Memory
    ├── Sensitivity: Acts as an overall win multiplier.
    │   All layers (I to VI) become extremely responsive.
    ├── Concentration: Reduces background “noise” by increasing the
    │   contrast between very active neurons and resting neurons.
    └── Learning: Triggers an instant “Memory Capture”
        (More charge sent to the Hippocampus/CA3).

🔭 Architecture overview (Road map)

├── docs/
│   ├── adr/
│   │   ├── adr001.md                   # ✅ Architecture Decision Records
│   │   └── adr002.md                   # ✅ Architecture Decision Records
│   ├── assets/                         # 📋 Medias
│   ├── examples/                       # 📋 Comprehensive example suite
│   ├── api-reference.md                # 📋 ...
│   ├── architecture.md                 # The technical plan
│   ├── genesis.md                      # The story of the project
│   ├── innovation-lab.md               # Innovation (Creation Lab)
│   ├── installation.md                 # Installation
│   ├── installation_fr.md              # Installation (FR)
│   ├── legend.md                       # 📋 ...
│   └── philosophy.md                   # The ethical vision
├── examples/                           # Comprehensive example suite
│   ├── basic-demo.html                 # 📋 ...
│   ├── learning-demo.html              # 📋 ...
│   └── memory-demo.html                # 📋 ...
├── src/
│   ├── anatomy/                        # Brain region implementations
│   │   ├── base/
│   │   │   ├── neuron.py               # Represents a single neuron
│   │   │   └── neuromodulator.py       # Chemical "gain controls"
│   │   ├── cortical/
│   │   │   ├── frontal.py              # ✅ Executive Logic & Command Center
│   │   │   ├── cortical_column.py      # ✅ Vertical organization of 6 cortical layers
│   │   │   ├── neocortex.py            # ✅ The structural integration of the 4 Lobes
│   │   │   ├── occipital.py            # ✅ Visual Stream Processor
│   │   │   ├── parietal.py             # ✅ Spatial Mapping & Data Integration
│   │   │   └── temporal.py             # ✅ Semantic Storage & Pattern Recognition
│   │   ├── limbic/
│   │   │   ├── amygdala.py             # Priority Filter & Interrupt Controller
│   │   │   ├── hippocampus.py          # Dynamic Buffer & Indexing System
│   │   │   └── limbic_system.py        # ✅ Limbic system
│   │   └── subcortical
│   │       ├── cerebellum.py           # Timing Engine & Output Calibration
│   │       ├── thalamic_hub.py         # 🚧 Thalamic Hub
│   │       └── thalamus.py             # Enhanced Thalamus implementation
│   ├── core/                           # Core neural components
│   │   ├── input_tactile.py            # ✅ Input tactile
│   │   ├── input_visual.py             # ✅ Input visual
│   │   ├── input_auditory.py           # ✅ Input auditory (Sounds to add)
│   │   ├── output_gateway.py           # 🚧 Input gateway
│   │   └── pulse.py                    # Core Pacemaker (Pulse)
│   ├── gui/                            # Web-based interface
│   │   ├── dashboard.py                # 🚧 ...
│   │   └── dashboard_fr.py             # 🚧 ... (FR)
│   ├── tests/                          # Comprehensive test suite
│   │   ├── test_amygdala.py            # ✅ Priority Filter & Interrupt Controller
│   │   ├── test_autonomy.py            # ✅ To validate the autonomous behaviors
│   │   ├── test_cerebellum.py          # ✅ Timing Engine & Output Calibration
│   │   ├── test_cortical_column.py     # ✅ Six-layer cortical signal flow
│   │   ├── test_hippocampus.py         # ✅ Dynamic Buffer & Indexing System
│   │   ├── test_limbic_system.py       # ✅ Limbic system
│   │   ├── test_neuron.py              # ✅ Represents a single neuron
│   │   ├── test_pulse.py               # ✅ Core Pacemaker (Pulse)
│   │   ├── test_trauma_logic.py        # ✅ Hippocampus Trauma Logic
│   │   └── test_thalamus.py            # ✅ Enhanced Thalamus implementation
│   ├── tests_fr/                       # Comprehensive test suite (FR)
│   │   ├── test_amygdala.py            # ✅ Priority Filter & Interrupt Controller (FR)
│   │   ├── test_autonomy.py            # ✅ To validate the autonomous behaviors (FR)
│   │   ├── test_cerebellum.py          # ✅ Timing Engine & Output Calibration (FR)
│   │   ├── test_cortical_column.py     # ✅ Six-layer cortical signal flow (FR)
│   │   ├── test_hippocampus.py         # ✅ Dynamic Buffer & Indexing System (FR)
│   │   ├── test_limbic_system.py       # ✅ Limbic system (FR)
│   │   ├── test_neuron.py              # ✅ Represents a single neuron (FR)
│   │   ├── test_pulse.py               # ✅ Core Pacemaker (Pulse) (FR)
│   │   ├── test_trauma_logic.py        # ✅ Hippocampus Trauma Logic (FR)
│   │   └── test_thalamus.py            # ✅ Enhanced Thalamus implementation (FR)
│   ├── config.py                       # ✅ Configuration Module
│   ├── main.py                         # ✅ The orchestrator
│   ├── main_fr.py                      # ✅ The orchestrator (FR)
│   └── registry.py                     # ✅ The Centralized Genome
├── CONTRIBUTING.md                     # The rules of collaboration
├── LICENSE                             # Protection license
└── README.md                           # Manifesto

📋 To Do
🚧 In progress
✅ Newly added

░▒▓ BT 2026-04-11