Skip to content

DaScient/Aegis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project Aegis: Organoid-Based Biocomputation

Building the Intellectual Architecture — An integrated biocomputation system combining organoid-derived neural networks with neuromorphic silicon co-processors.

Overview

Project Aegis explores hybrid biocomputation by integrating:

  • Organoid cultivation systems: Multi-well bioreactors with real-time environmental monitoring
  • Neural signal acquisition: 3D mesh electrode arrays with 256+ recording channels
  • Optogenetic stimulation: Wavelength-tuned light interfaces for precise neural control
  • Distributed synchronization: Multi-organoid coupling via electrical, microfluidic, and optical modalities
  • Silicon integration: Neuromorphic middleware for task translation to specialized accelerators
  • Active inference: Variational free-energy minimization for adaptive control policies

The system enables research in embodied cognition, collective intelligence, and bio-integrated computing with ethical oversight via tiered consent frameworks.


Project Structure

Project-Aegis-OI/
├── .github/workflows/
│   └── bio-digital-ci-cd.yml              # CI/CD validation pipeline
├── docs/
│   ├── architecture/
│   │   └── living_data_centers.md         # Infrastructure for bioreactors
│   └── ethics/
│       └── donor_rights_policy.md         # Tiered consent framework
├── hardware/
│   ├── microfluidic_perfusion/
│   │   ├── pump_controller.py             # Flow regulation
│   │   └── flow_dynamics_model.ipynb      # Oxygen diffusion simulation
│   ├── 3d_mesh_electrodes/
│   │   ├── mesh_geometry_config.json      # Electrode array geometry
│   │   └── electrode_map_generator.rs     # Volumetric mapping
│   └── optogenetic_interfaces/
│       ├── opsin_calibration_tool.py      # Wavelength/intensity tuning
│       └── optical_stim_patterns.yaml     # Pre-defined light sequences
├── notebooks/
│   ├── 01_organoid_growth_analytics.ipynb # Transcriptomic maturation tracking
│   └── 02_reservoir_capacity_benchmarks.ipynb  # Memory and separability metrics
├── src/
│   ├── organoid_culture/
│   │   ├── dual_smad_induction.py         # SMAD-mediated neuroectoderm patterning
│   │   └── orbital_maturation_logic.py    # Bioreactor agitation schedules
│   ├── signal_processing/
│   │   ├── template_matching.rs           # Real-time spike detection
│   │   └── spike_train_entropy_lib.py     # Information-theoretic analysis
│   ├── distributed_routing/
│   │   ├── synchronization_manager.py     # Multi-organoid coupling
│   │   └── programmable_delay_lines.rs    # Signal latency management
│   └── hybrid_control_api/
│       ├── neuromorphic_middleware.py     # Spike-to-silicon translation
│       └── active_inference_engine.py     # Variational control policies
├── tests/
│   ├── test_perfusion_stability.py        # Perfusion validation
│   └── test_spike_sorting_accuracy.py     # Detection accuracy verification
├── LICENSE                                # MIT License
└── README.md                              # This file

Key Modules

Hardware Control

Microfluidic Perfusion (hardware/microfluidic_perfusion/)

  • pump_controller.py: Regulates nutrient delivery and waste removal via active perfusion

    • Steady-state and pulsed flow modes
    • Prevents necrosis through optimal nutrient gradients
  • flow_dynamics_model.ipynb: Simulates oxygen diffusion in channel geometries

    • Michaelis-Menten consumption kinetics
    • Predicts hypoxic regions requiring intervention

3D Mesh Electrodes (hardware/3d_mesh_electrodes/)

  • electrode_map_generator.rs: Generates tetrahedral lattice for 256-channel recording

    • Volumetric signal coordinate mapping
    • Conformal tissue coupling
  • mesh_geometry_config.json: Configures electrode impedance and contact properties

Optogenetic Interfaces (hardware/optogenetic_interfaces/)

  • opsin_calibration_tool.py: Wavelength and intensity characterization for ChR2, NpHR, ArchT

    • Photocurrent response measurements
    • Kinetic parameter fitting
  • optical_stim_patterns.yaml: Pre-designed protocols including:

    • Frequency sweeps for neural characterization
    • Traveling wave patterns for connectivity mapping
    • Adaptive feedback for homeostatic control

Organoid Culture Operations

Differentiation (src/organoid_culture/)

  • dual_smad_induction.py: SMAD inhibitor-based neuroectoderm patterning

    • Days 0-3: SMAD inhibition induction
    • Days 3-6: Neural progenitor specification
    • Days 6+: Neural stem cell expansion
  • orbital_maturation_logic.py: Schedules bioreactor agitation throughout development

    • Phase-dependent RPM and reversal frequency adjustment
    • Calculated shear stress profiles
    • Prevents necrosis through optimal fluid dynamics

Signal Processing & Analysis

Detection (src/signal_processing/)

  • template_matching.rs: Real-time spike detection pipeline

    • Canonical spike template matching
    • Refractory period enforcement
    • Burst detection with adjustable thresholds
  • spike_train_entropy_lib.py: Information-theoretic metrics

    • Shannon entropy of spike trains
    • Inter-spike interval analysis
    • Mutual information and transfer entropy between neurons
    • Network characterization via information flow

Distributed Biocomputation

Multi-Organoid Synchronization (src/distributed_routing/)

  • synchronization_manager.py: Orchestrates multi-organoid coupling

    • Electrical coupling (direct electrode-mediated)
    • Microfluidic coupling (molecular signaling)
    • Optogenetic coordination
    • Dynamic coupling strength adjustment
  • programmable_delay_lines.rs: Manages signal latency

    • Compensates for biological propagation delays
    • Enables phase-locked synchronization
    • Buffer management for real-time processing

Hybrid Control (src/hybrid_control_api/)

  • neuromorphic_middleware.py: Translates spike patterns for silicon accelerators

    • Rate coding, temporal coding, population codes
    • Address-Event Representation (AER) format
    • Task registration and hardware requirement specification
  • active_inference_engine.py: Variational free-energy minimization

    • Bayesian belief updating with observations
    • Multi-step action planning
    • Epistemic (information-seeking) vs. pragmatic (goal-oriented) tradeoffs

Analysis Notebooks

  • 01_organoid_growth_analytics.ipynb: Tracks maturation via gene expression

    • Neural stem cell → neuron → synapse → network progression
    • Transcriptomic audit markers
    • Developmental stage classification
  • 02_reservoir_capacity_benchmarks.ipynb: Evaluates reservoir computing properties

    • Fading memory capacity assessment
    • Input separability metrics
    • Non-linear dynamical characterization

Testing & Validation

  • test_perfusion_stability.py: Validates flow rates, waste removal, oxygen delivery
  • test_spike_sorting_accuracy.py: Bench detection against synthetic ground truth

Installation & Setup

Prerequisites

  • Python 3.10+
  • Rust 1.70+ (for delay lines and electrode mapping)
  • Jupyter Notebook
  • NumPy, SciPy, Pandas, scikit-learn
  • pytest for running test suites

Installation

# Clone repository
git clone https://github.com/DaScient/Aegis.git
cd Aegis

# Install Python dependencies
pip install -r requirements.txt

# Build Rust components (if available)
cd hardware/3d_mesh_electrodes
cargo build --release
cd ../../src/signal_processing
cargo build --release
cd ../../src/distributed_routing
cargo build --release

# Run tests
pytest tests/ -v

Workflow Examples

Example 1: Organoid Culture Protocol

from src.organoid_culture.dual_smad_induction import DualSmadInductionProtocol
from src.organoid_culture.orbital_maturation_logic import OrbitalMaturationLogic

# Initialize protocol
protocol = DualSmadInductionProtocol(cell_line="iPSC")
culture_condition = protocol.setup_dual_smad_inhibition(protocol_variant="optimized")

# Stage 1: Induction
result_stage1 = protocol.day_0_to_3_induction(culture_condition)

# Orbital maturation scheduling
orbital = OrbitalMaturationLogic(well_format="24-well")
schedule = orbital.generate_schedule(total_days=30)

Example 2: Real-Time Spike Detection

from src.signal_processing.template_matching import TemplateMatchingDetector

detector = TemplateMatchingDetector(sampling_rate_hz=30000.0)
template = TemplateMatchingDetector.create_canonical_template()
detector.add_template(template)

# Process incoming signal
spike_times = []
for sample in neural_recording:
    event = detector.process_sample(sample, current_time_ms)
    if event is not None:
        spike_times.append(event.timestamp_ms)

Example 3: Multi-Organoid Synchronization

from src.distributed_routing.synchronization_manager import SynchronizationManager, CouplingMethod

sync_mgr = SynchronizationManager(num_organoids=4)

# Establish electrical coupling
sync_mgr.configure_electrical_coupling(source_id=0, target_id=1)

# Establish microfluidic coupling
sync_mgr.configure_microfluidic_coupling(source_id=1, target_id=2)

# Get network topology
topology = sync_mgr.get_network_topology()

Example 4: Active Inference Control

from src.hybrid_control_api.active_inference_engine import ActiveInferenceEngine

engine = ActiveInferenceEngine(num_hidden_states=100)

# Update beliefs based on observations
observations = neural_recording[:256]
params = engine.update_beliefs(observations, learning_rate=0.01)

# Plan future actions
policies = engine.plan_actions(planning_horizon=5, num_candidate_policies=10)
best_policy = engine.select_policy(policies)
engine.execute_policy(best_policy)

Key Features

Biological Fidelity

  • Dual SMAD inhibition for directed neuroectoderm differentiation
  • Microfluidic perfusion maintains physiological oxygen gradients
  • 3D mesh electrodes capture volumetric neural activity
  • Optogenetic precision enables circuit-level interrogation

Computational Integration

  • Neuromorphic middleware translates spike patterns to silicon accelerators
  • Active inference enables adaptive, goal-directed control
  • Information-theoretic analysis quantifies network computation
  • Programmable delay lines enable distributed multi-organoid coordination

Ethical Framework

  • Tiered consent system for computational use of donor-derived tissues
  • Transparency mechanisms for computational applications
  • Data minimization principles and audit capabilities
  • Revenue-sharing agreements for commercial applications

Documentation


References & Citations

Key publications are cited throughout the codebase (formatted as [cite: page_range]). These citations correspond to peer-reviewed research foundational to each module:

  • Microfluidic perfusion physiology and optimization
  • Organoid differentiation protocols via SMAD signaling
  • Spike detection and sorting best practices
  • Neuromorphic computing architectures
  • Variational inference and active inference theory
  • Multi-scale biocomputation systems

License

This project is licensed under the MIT License — see LICENSE for details.

The MIT License permits open scientific use while encouraging attribution. For commercial applications involving donor tissues, see the Donor Rights Policy regarding revenue-sharing obligations.


Contributing

We welcome contributions from researchers, engineers, and ethicists. Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/your-feature)
  3. Commit changes with clear messages
  4. Submit a pull request with documentation
  5. Ensure all tests pass: pytest tests/ -v

Contact & Support

Project Lead: DaScient
Issue Tracker: GitHub Issues
Discussions: GitHub Discussions


Acknowledgments

Project Aegis represents a convergence of organoid biology, bioelectronics, neuromorphic computing, and active inference. We acknowledge the diverse research communities that made this work possible.


"Building the Intellectual Architecture" — An exploration of bio-integrated computation as substrate for embodied cognition and collective intelligence.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors