{"id":29473405,"url":"https://github.com/fullscreen-triangle/nebuchadnezzar","last_synced_at":"2025-07-14T15:38:44.696Z","repository":{"id":299824923,"uuid":"1004239266","full_name":"fullscreen-triangle/nebuchadnezzar","owner":"fullscreen-triangle","description":"Hierarchical Probabilistic Electric Circuit System for Biological Simulation","archived":false,"fork":false,"pushed_at":"2025-06-25T23:52:39.000Z","size":2617,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-26T00:31:43.620Z","etag":null,"topics":["cell-simulation","systems-biology"],"latest_commit_sha":null,"homepage":"https://fullscreen-triangle.github.io/nebuchadnezzar/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fullscreen-triangle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-18T10:24:24.000Z","updated_at":"2025-06-25T23:52:43.000Z","dependencies_parsed_at":"2025-06-18T14:35:40.431Z","dependency_job_id":null,"html_url":"https://github.com/fullscreen-triangle/nebuchadnezzar","commit_stats":null,"previous_names":["fullscreen-triangle/nebuchadnezzar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fullscreen-triangle/nebuchadnezzar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullscreen-triangle%2Fnebuchadnezzar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullscreen-triangle%2Fnebuchadnezzar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullscreen-triangle%2Fnebuchadnezzar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullscreen-triangle%2Fnebuchadnezzar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fullscreen-triangle","download_url":"https://codeload.github.com/fullscreen-triangle/nebuchadnezzar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fullscreen-triangle%2Fnebuchadnezzar/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265313460,"owners_count":23745190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cell-simulation","systems-biology"],"created_at":"2025-07-14T15:38:43.637Z","updated_at":"2025-07-14T15:38:44.655Z","avatar_url":"https://github.com/fullscreen-triangle.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nebuchadnezzar: Intracellular Dynamics Engine\n\n[![Rust](https://img.shields.io/badge/rust-1.70+-blue.svg)](https://www.rust-lang.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\u003e **A comprehensive framework for modeling intracellular processes using ATP as the fundamental rate unit. Designed as the foundational intracellular dynamics package for constructing biologically authentic neurons.**\n\n## 🧠 Overview\n\nNebuchadnezzar serves as the **intracellular dynamics foundation** for the neurobiological simulation ecosystem:\n\n- **🏗️ Nebuchadnezzar**: Intracellular dynamics engine (this package)\n- **🛣️ Autobahn**: RAG system integration for knowledge processing\n- **🧬 Bene Gesserit**: Membrane dynamics and quantum transport\n- **⚡ Imhotep**: Neural interface and consciousness emergence\n\n## ✨ Core Features\n\n### 🔋 ATP-Constrained Dynamics\n- Uses `dx/dATP` equations instead of `dx/dt` for metabolically realistic computation\n- Energy charge-dependent processing rates\n- Physiological ATP pool management with synthesis/consumption balance\n\n### 🎯 Biological Maxwell's Demons (BMDs)\n- Information catalysts for selective pattern recognition\n- Prisoner parable implementation (minimal input → massive thermodynamic consequences)\n- Five BMD categories: Molecular, Cellular, Neural, Metabolic, Membrane\n- Thermodynamic consistency and metastability tracking\n\n### 🌊 Quantum Membrane Transport\n- Environment-assisted quantum coherence at biological temperatures\n- Ion channel modeling with quantum tunneling effects\n- Decoherence mitigation through environmental coupling\n\n### 📊 Multi-Scale Oscillatory Dynamics\n- Hierarchical oscillator networks from molecular to cellular scales\n- Neural frequency band support (Delta, Theta, Alpha, Beta, Gamma)\n- Hardware oscillation harvesting for zero-overhead rhythm generation\n\n### 🖥️ Hardware Integration\n- Direct coupling with system oscillations (CPU, GPU, network)\n- Environmental noise harvesting for biological realism\n- Screen backlight PWM integration for visual processing\n\n## 🚀 Quick Start\n\n### Basic Integration API\n\n```rust\nuse nebuchadnezzar::prelude::*;\n\n// Create intracellular environment for neuron construction\nlet intracellular = IntracellularEnvironment::builder()\n    .with_atp_pool(AtpPool::new_physiological())\n    .with_oscillatory_dynamics(OscillatoryConfig::biological())\n    .with_membrane_quantum_transport(true)\n    .with_maxwell_demons(BMDConfig::neural_optimized())\n    .with_hardware_integration(true)\n    .build()?;\n\n// Ready for integration with Autobahn, Bene Gesserit, and Imhotep\nprintln!(\"Integration ready: {}\", intracellular.integration_ready());\n```\n\n### Neuron Construction Kit\n\n```rust\n// Create neuron construction kit with integration interfaces\nlet neuron_kit = NeuronConstructionKit::new(intracellular)\n    .with_autobahn(AutobahnInterface {\n        knowledge_processing_rate: 1000.0, // bits/s\n        retrieval_efficiency: 0.85,\n        generation_quality: 0.90,\n    })\n    .with_bene_gesserit(BeneGesseritInterface {\n        membrane_dynamics_coupling: 0.8,\n        hardware_oscillation_harvesting: true,\n        pixel_noise_optimization: true,\n    })\n    .with_imhotep(ImhotepInterface {\n        consciousness_emergence_threshold: 0.7,\n        neural_interface_active: true,\n        bmd_neural_processing: true,\n    });\n\n// Check if ready for complete neuron construction\nif neuron_kit.integration_complete() {\n    println!(\"🚀 Ready for Imhotep neuron construction!\");\n}\n```\n\n### ATP-Constrained Differential Equations\n\n```rust\nlet mut solver = AtpDifferentialSolver::new(5.0); // 5 mM initial ATP\n\n// Define enzymatic reaction: S + ATP -\u003e P + ADP\nlet enzymatic_reaction = |substrate: f64, atp: f64| -\u003e f64 {\n    let km = 2.0; // mM\n    let vmax = 5.0; // mM/s per mM ATP\n    vmax * atp * substrate / (km + substrate)\n};\n\nlet result = solver.solve_atp_differential(\n    10.0,           // Initial substrate concentration\n    enzymatic_reaction,\n    0.5             // ATP consumption per reaction\n);\n```\n\n### Biological Maxwell's Demons\n\n```rust\n// Create information catalyst for neural signal processing\nlet pattern_selector = PatternSelector::new()\n    .with_recognition_threshold(0.7)\n    .with_specificity_for(\"neural_signal\");\n\nlet target_channel = TargetChannel::new()\n    .with_target(\"action_potential\")\n    .with_efficiency(0.85);\n\nlet catalyst = InformationCatalyst::new(\n    pattern_selector, \n    target_channel, \n    1000.0 // Amplification factor\n);\n```\n\n## 📚 Examples\n\nRun the comprehensive integration demo:\n\n```bash\ncargo run --example neuron_integration_demo\n```\n\nOther examples:\n- `simple_bmd_test` - Basic BMD functionality\n- `glycolysis_circuit` - Metabolic pathway modeling\n- `comprehensive_simulation` - Full system demonstration\n- `quantum_biological_computer_demo` - Quantum processing\n- `atp_oscillatory_membrane_complete_demo` - Membrane dynamics\n\n## 🏗️ Architecture\n\n### Integration-Focused Design\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    Imhotep (Neural Interface)               │\n│                  Consciousness Emergence                    │\n└─────────────────────┬───────────────────────────────────────┘\n                      │\n┌─────────────────────┼───────────────────────────────────────┐\n│                     │  Neuron Construction                  │\n│  ┌─────────────┐   │   ┌─────────────┐   ┌─────────────┐   │\n│  │  Autobahn   │───┼───│Nebuchadnezzar│───│Bene Gesserit│   │\n│  │    (RAG)    │   │   │(Intracellular)│   │ (Membrane)  │   │\n│  └─────────────┘   │   └─────────────┘   └─────────────┘   │\n└─────────────────────┼───────────────────────────────────────┘\n                      │\n              ┌───────▼────────┐\n              │ Hardware Layer │\n              │ (Oscillations, │\n              │ Noise, Pixels) │\n              └────────────────┘\n```\n\n### Core Components\n\n- **`IntracellularEnvironment`**: Main integration interface\n- **`AtpSystem`**: Energy management and ATP kinetics\n- **`BMDSystem`**: Information processing and pattern recognition\n- **`OscillatorySystem`**: Multi-scale temporal dynamics\n- **`MembraneSystem`**: Quantum transport and ion channels\n- **`HardwareSystem`**: Environmental coupling and harvesting\n- **`CircuitSystem`**: Hierarchical probabilistic circuits\n\n## 🔬 Scientific Foundation\n\n### ATP as Rate Unit\nInstead of traditional time-based differential equations (`dx/dt`), Nebuchadnezzar uses ATP consumption as the fundamental rate unit (`dx/dATP`). This provides:\n\n- **Metabolic Realism**: Computation directly tied to cellular energy availability\n- **Natural Rate Limiting**: Processes automatically slow when ATP is depleted\n- **Biological Accuracy**: Reflects actual cellular energy constraints\n\n### Biological Maxwell's Demons\nBased on Eduardo Mizraji's 2021 theoretical framework:\n\n- **Information Catalysts**: `iCat = ℑ_input ◦ ℑ_output`\n- **Pattern Recognition**: Selective amplification of biologically relevant signals\n- **Thermodynamic Consistency**: Energy conservation with entropy considerations\n- **Fire-Light Optimization**: Enhanced performance at 600-700nm wavelengths\n\n### Quantum Coherence at Biological Temperatures\n- **Environment-Assisted Coherence**: Noise as a resource rather than detriment\n- **Decoherence Mitigation**: Strategic environmental coupling\n- **Ion Channel Quantum Effects**: Tunneling and superposition in transport\n\n## 🛠️ Development\n\n### Prerequisites\n- Rust 1.70+\n- Standard scientific computing dependencies (see `Cargo.toml`)\n\n### Building\n```bash\n# Standard build\ncargo build\n\n# Release build with optimizations\ncargo build --release\n\n# With all features\ncargo build --features full\n```\n\n### Testing\n```bash\n# Run tests\ncargo test\n\n# Run benchmarks\ncargo bench\n\n# Run examples\ncargo run --example neuron_integration_demo\n```\n\n### Features\n- `default`: Core functionality\n- `visualization`: Plotting and visualization tools\n- `graph_analysis`: Advanced graph algorithms\n- `full`: All features enabled\n\n## 📖 Documentation\n\n- **API Documentation**: `cargo doc --open`\n- **Examples**: See `examples/` directory\n- **Theoretical Background**: See `docs/` directory\n\n## 🤝 Integration with Other Packages\n\n### For Autobahn Integration\n```rust\nuse nebuchadnezzar::prelude::*;\n\nlet intracellular = IntracellularEnvironment::builder()\n    .with_maxwell_demons(BMDConfig::neural_optimized())\n    .build()?;\n\n// Connect to Autobahn RAG system\nlet autobahn_interface = AutobahnInterface {\n    knowledge_processing_rate: intracellular.state.information_processing_rate,\n    retrieval_efficiency: 0.85,\n    generation_quality: 0.90,\n};\n```\n\n### For Bene Gesserit Integration\n```rust\nlet bene_gesserit_interface = BeneGesseritInterface {\n    membrane_dynamics_coupling: intracellular.state.quantum_coherence,\n    hardware_oscillation_harvesting: true,\n    pixel_noise_optimization: true,\n};\n```\n\n### For Imhotep Integration\n```rust\nlet imhotep_interface = ImhotepInterface {\n    consciousness_emergence_threshold: 0.7,\n    neural_interface_active: intracellular.integration_ready(),\n    bmd_neural_processing: true,\n};\n```\n\n## 📊 Performance\n\n- **Zero-overhead oscillations**: Hardware harvesting eliminates computational cost\n- **ATP-constrained computation**: Natural rate limiting prevents runaway processes\n- **Quantum coherence**: Enhanced processing efficiency at biological temperatures\n- **Parallel processing**: Multi-core BMD information catalysis\n\n## 🔮 Future Directions\n\n- **Enhanced BMD Categories**: Expand beyond the current five types\n- **Advanced Quantum Effects**: Incorporate more sophisticated quantum phenomena\n- **Hardware Integration**: Deeper coupling with specialized hardware\n- **Consciousness Emergence**: Better integration with Imhotep consciousness models\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Eduardo Mizraji for the Biological Maxwell's Demons theoretical framework\n- The quantum biology community for environment-assisted coherence insights\n- The systems biology community for ATP-centric modeling approaches\n\n---\n\n**Ready to build biologically authentic neurons with quantum processing capabilities? Start with Nebuchadnezzar as your intracellular dynamics foundation!** 🧠⚡\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullscreen-triangle%2Fnebuchadnezzar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffullscreen-triangle%2Fnebuchadnezzar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffullscreen-triangle%2Fnebuchadnezzar/lists"}