"Intelligence by Design, Stability by Physics"
ENTRO-CORE is the third project of the EntropyLab research program (E-LAB-03). It investigates entropy-based control architectures for dynamical systems, introducing a hybrid regime-switching controller that combines PID with nonlinear entropy feedback.
Project Code: E-LAB-03 | Lab: Entropy Research Lab | Submitted: April 2026
- Overview
- Key Finding
- Control Laws
- Experimental Results
- Project Structure
- Installation
- Quick Start
- Validation
- EntropyLab Roadmap
- Documentation
- Citation
- Author
- License
Modern AI systems operate under high-dimensional feedback loops that can lead to instability, especially under long-context reasoning or recursive inference. ENTRO-CORE moves entropy control from an external monitoring layer (ENTRO-AI) into the core control architecture itself.
Instead of: Monitor β Detect β Intervene (reactive)
ENTRO-CORE does: Self-regulate internally (proactive)
| Metric | Value |
|---|---|
| PID Final Ξ¨ (stable regime) | 0.017 |
| ENTRO-CORE Final Ξ¨ | -0.239 |
| Hybrid Final Ξ¨ | -0.012 |
| Validation Runs | 5 runs per controller |
| Noise Robustness | Ο = 0.00 β 0.15 |
Entropy-based control is regime-dependent, not universally superior.
PID remains optimal in stable linear systems, while entropy-based control provides benefits in near-critical regimes.
| Regime | Optimal Controller |
|---|---|
| Stable linear | PID |
| Near-critical / nonlinear | ENTRO-CORE / Hybrid |
u_PID(t) = K_pΒ·e(t) + K_iΒ·β«e(Ο)dΟ + K_dΒ·Δ(t)
with e(t) = -Ξ¨(t), K_p=0.8, K_i=0.2, K_d=0.3
u_ENTRO(t) = wβΒ·Ο(Ξ¨_norm - ΞΈ) + wβΒ·tanh(Ξ¨Μ) + wβΒ·tanh(Ξ¨Μ)
with wβ=0.5, wβ=0.3, wβ=0.2, ΞΈ=1.4
u(t) = { u_PID(t) if Ξ¨(t) < Ξ¨_th
{ u_ENTRO(t) if Ξ¨(t) β₯ Ξ¨_th
with switching threshold Ξ¨_th = 1.7
Under near-critical initial conditions (Ξ¨(0)=1.8, Ξ¨Μ(0)=0.3):
| Controller | Final Ξ¨ (t=20s) | Outcome |
|---|---|---|
| Uncontrolled | 0.053 | Naturally stable |
| PID | 0.017 | Optimal convergence |
| ENTRO-CORE v1 | -0.239 | Mild overshoot |
| Hybrid (threshold=1.7) | -0.012 | Robust performance |
| Noise Ο | Final Ξ¨ | Outcome |
|---|---|---|
| 0.00 | 0.339 | Stabilized |
| 0.02 | 0.341 | Stabilized |
| 0.05 | 0.355 | Stabilized |
| 0.10 | 0.412 | Stabilized |
| 0.15 | 0.523 | Stabilized |
entro-core/
β
βββ π README.md # This file
βββ π LICENSE # MIT License
βββ π CHANGELOG.md # Version history
βββ π CONTRIBUTING.md # Contribution guidelines
βββ π CITATION.cff # Academic citation metadata
βββ π pyproject.toml # Build configuration
βββ π requirements.txt # Runtime dependencies
βββ π requirements-dev.txt # Development dependencies
β
βββ π entro_core/ # Core Python package
β βββ π init.py # Package entry point
β βββ π controller.py # ENTRO-CORE v1 (original)
β βββ π controller_v2.py # ENTRO-CORE v2 (negative feedback)
β βββ π hybrid_controller.py # Regime-switching controller
β βββ π actuator.py # Actuation strategies
β βββ π normalize.py # Logistic normalization (Eq. 4)
β βββ π state.py # State tracker (Ξ¨, Ξ¨Μ, Ξ¨Μ)
β βββ π control_law.py # Control law u(t) (Eq. 5)
β
βββ π simulation/ # Validation simulations
β βββ π generate_figures_fixed.py # Trajectory generation
β βββ π validation_experiment.py # Full validation suite
β βββ π hybrid_test.py # Hybrid controller test
β βββ π results/
β βββ π trajectories_fixed.csv # Comparison data
β
βββ π tests/ # Unit tests
β βββ π test_controller.py # Controller tests (21 tests)
β βββ π init.py
β
βββ π paper/ # Research paper assets
β βββ π arxiv/
β βββ π entro_core_paper_revised.tex # LaTeX manuscript
β
βββ π docs/ # Documentation
βββ π index.md
βββ π control_theory.md
βββ π api_reference.md
- Python 3.11+
- No external dependencies required (pure Python)
pip install entro-coreFrom Source
git clone https://github.com/gitdeeper10/entro-core.git
cd entro-core
pip install -e ".[dev]"π Quick Start
- Import and Use Hybrid Controller
from entro_core.hybrid_controller import HybridController
# Create controller with threshold
controller = HybridController(threshold=1.7)
# Simulate a near-critical state
result = controller.step(psi=1.8)
print(f"u(t) = {result.u:.3f}")
print(f"Mode: {result.mode}") # 'PID' or 'ENTRO-CORE'
print(f"Active: {result.is_active}")u(t) = 0.423
Mode: ENTRO-CORE
Active: True
- Run Validation Experiment
python simulation/validation_experiment.py- Generate Comparison Trajectories
python simulation/generate_figures_fixed.pyπ Validation Results
Test Suite (21 tests)
Category Passed Normalization 4/4 β Sigmoid 3/3 β Tanh 3/3 β Control Law 3/3 β Actuation 4/4 β Controller 4/4 β Total 21/21
πΊοΈ EntropyLab Research Roadmap
E-LAB-01 β
ENTROPIA β Thermodynamic unification
E-LAB-02 β
ENTRO-AI β Entropy-resistant AI inference
E-LAB-03 β
ENTRO-CORE β Regime-dependent control (this repository)
E-LAB-04 π
ENTRO-ENGINE β Generalized entropy control framework
E-LAB-05 π
ENTRO-FIN β Financial entropic dynamics
E-LAB-06 π
ENTRO-SOCIAL β Information cascades in networks
E-LAB-07 π
ENTRO-QUANTUM β Quantum entropy extension
E-LAB-08 π
ENTRO-BIO β Biological neural entropy systems
E-LAB-09 π
ENTRO-CLIMATE β Climate entropy modeling
E-LAB-10 π
ENTRO-META β Unified entropy control theory
β Complete | π In Progress | π Planned
π Documentation
Resource Link Full Documentation entropia-lab.netlify.app/entro-core/docs Research Paper (PDF) entropia-lab.netlify.app/entro-core/paper API Reference entropia-lab.netlify.app/entro-core/api Parent Project (ENTRO-AI) entro-ai.netlify.app Foundation (ENTROPIA) doi.org/10.5281/zenodo.19416737
π€ Contributing
git clone https://github.com/gitdeeper10/entro-core.git
cd entro-core
pip install -e ".[dev]"
pytest tests/Priority contribution areas:
Β· Smooth switching (sigmoidal interpolation) Β· Additional system dynamics models Β· Real-world validation datasets
π Citation
@software{baladi2026entrocore,
author = {Samir Baladi},
title = {ENTRO-CORE: Regime-Dependent Entropy-Augmented Control},
year = {2026},
version = {0.1.0},
publisher = {Zenodo},
doi = {10.5281/zenodo.19431029},
url = {https://doi.org/10.5281/zenodo.19431029},
note = {E-LAB-03. Builds on E-LAB-01 and E-LAB-02}
}Parent frameworks:
@article{baladi2026entropia,
title = {ENTROPIA: Statistical Dynamics of Information Dissipation},
author = {Samir Baladi},
year = {2026},
doi = {10.5281/zenodo.19416737},
note = {E-LAB-01}
}
@software{baladi2026entroai,
author = {Samir Baladi},
title = {ENTRO-AI: Entropy-Resistant Inference Architecture},
year = {2026},
version = {2.0.0},
doi = {10.5281/zenodo.19284086},
note = {E-LAB-02}
}π€ Author
Samir Baladi
Β· Role: Principal Investigator, Interdisciplinary AI Researcher Β· Affiliation: Ronin Institute / Rite of Renaissance Β· Email: gitdeeper@gmail.com Β· ORCID: 0009-0003-8903-0029 Β· GitHub: github.com/gitdeeper10 Β· GitLab: gitlab.com/gitdeeper10
π License
MIT License β see LICENSE for details.
ENTRO-CORE β Entropy Research Lab β E-LAB-03
Regime-Dependent Entropy-Augmented Control
https://img.shields.io/badge/PyPI-pip_install_entro--core-red.svg https://img.shields.io/badge/DOI-10.5281/zenodo.19431029-blue.svg
entropia-lab.netlify.app Β· pip install entro-core
Builds on ENTROPIA (E-LAB-01) and ENTRO-AI (E-LAB-02)