Technical Documentation · API Reference · Entropy Flow Regulation

ENTRO-ENGINE

Documentation

Complete guide for entropy flow regulation in coupled intelligence systems. Global budget constraint: Ψ_total = Ψ_s + Ψ_l ≤ Ψ_budget

DOI: 10.5281/zenodo.19441032 Python 3.11+ MIT License 9 Tests 3 Regimes
v1.0.0 · Stable Released: April 6, 2026 96.2% Budget Violation Reduction 73.3% Peak Queue Reduction 43.3% Peak Ψ_total Reduction

From local control to global coordination

"A single engine regulates itself. A fleet of engines requires a coordinator." — Samir Baladi, April 2026

ENTRO-ENGINE coordinates entropy flow between coupled systems (Scraper → LLM) under a global entropy budget constraint. Unlike ENTRO-CORE which stabilizes a single system, ENTRO-ENGINE distributes corrective pressure across multiple subsystems in proportion to their entropy contribution.

96.2%
Budget Violations ↓
312 → 12 timesteps
73.3%
Peak Queue ↓
87.6 → 23.4 requests
43.3%
Peak Ψ_total ↓
5.84 → 3.31
3
Regimes
Stable, Stress, Critical

Global Entropy Budget

// Instead of controlling each system independently // ENTRO-ENGINE manages a shared entropy budget Ψ_total = Ψ_scraper + Ψ_llm ≤ Ψ_budget // Budget parameterization (Eq. 10) Ψ_budget = γ_budget · N · Ψ_c = 0.75 × 2 × 2.0 = 3.0

Proportional Allocation

// ENTRO-ENGINE Control Law (Eq. 14) u_i(t) = -α · ρ_i(t) · tanh(β · Δ(t)) // Where: // α = 0.5 (control authority) // β = 2.0 (pressure sensitivity) // ρ_i = Ψ_i / Ψ_total (fractional entropy ratio) // Δ = max(0, Ψ_total - Ψ_budget) (budget pressure) // Entropy proxies (Eq. 6-7) Ψ_s = log(1 + r_s) // Scraper entropy Ψ_l = log(1 + q_l) // LLM entropy

Thermodynamic Fairness

// Proportional allocation ensures fairness // Subsystems generating more entropy receive more corrective pressure ρ_s = Ψ_s / Ψ_total ρ_l = Ψ_l / Ψ_total ρ_s + ρ_l = 1 // When Ψ_total exceeds budget, each subsystem's control signal is // proportional to its entropy contribution
ParameterSymbolValueDescription
Control Authorityα0.5Maximum control signal magnitude
Pressure Sensitivityβ2.0Tanh sensitivity to budget violation
Entropy BudgetΨ_budget3.0Global entropy limit (γ=0.75, N=2, Ψ_c=2.0)
Max Scraper Rater_max3.0 req/sMaximum request rate
Max LLM Queueq_max10.0Maximum queue length
LLM Capacityc_max1.2 req/sMaximum processing capacity

Three-Phase Pipeline Simulation

ControllerBudget ViolationsPeak QueuePeak Ψ_total
Uncontrolled31287.65.84
Static Limit18745.24.21
ENTRO-ENGINE1223.43.31
96.2%
Budget Violations ↓
ENTRO-ENGINE vs Uncontrolled
73.3%
Peak Queue ↓
ENTRO-ENGINE vs Uncontrolled
43.3%
Peak Ψ_total ↓
ENTRO-ENGINE vs Uncontrolled

ENTRO-ENGINE v9 Final Results

RegimeCountPercentage
Stable2430.0%
Stress1923.75%
Critical3746.25%
"A single engine regulates itself. A fleet of engines requires a coordinator. ENTRO-ENGINE is the coordinator — not because it overrides each engine's autonomy, but because it holds the budget that no single engine can see alone."

Quick setup

# Install from PyPI pip install entro-engine # Clone repository git clone https://github.com/gitdeeper10/entro-engine.git cd entro-engine # Install with pip pip install -r requirements.txt pip install -e . # Verify installation python -c "from entro_engine import __version__; print(__version__)"

Python interface

ENTROEngineController
Main ENTRO-ENGINE controller class
from entro_engine import ENTROEngineController # Initialize controller controller = ENTROEngineController( alpha=0.5, beta=2.0, psi_budget=3.0 ) # Compute control signal for a subsystem signal = controller.compute_control( psi_i=1.5, psi_total=4.0 ) print(f"u = {signal.u:.3f}")
EntropyBudget
Budget manager with violation tracking
from entro_engine import EntropyBudget budget = EntropyBudget(psi_budget=3.0) status = budget.check(psi_total=3.5) print(f"Violation: {status.violation:.3f}") print(f"Remaining: {status.remaining:.3f}")
ProportionalAllocator
Proportional allocation based on entropy ratios
from entro_engine import ProportionalAllocator allocator = ProportionalAllocator(alpha=0.5, beta=2.0) result = allocator.allocate({ "scraper": 1.5, "llm": 2.5 }) for name, alloc in result.items(): print(f"{name}: u={alloc.allocated_u:.3f}, ρ={alloc.rho:.3f}")

ENTRO-ENGINE architecture

controller.py
ENTRO-ENGINE
Main control law (Eq. 14)
budget.py
Budget Manager
Violation tracking (Eq. 9-11)
allocator.py
Allocator
Proportional allocation (Eq. 12-13)
entro_engine_v9.py
v9 Engine
Balanced regime engine
simulator_v9.py
Simulator
Three-phase pipeline
daily_report.py
Reports
Daily/Weekly/Monthly

Principal investigator

🔴

Samir Baladi

Interdisciplinary AI Researcher — Theoretical Physics, Statistical Mechanics & Information Theory
Ronin Institute / Rite of Renaissance
Samir Baladi is an independent researcher affiliated with the Ronin Institute, developing the Rite of Renaissance interdisciplinary research program. ENTRO-ENGINE is the fourth project (E-LAB-04) in a ten-project research program, building directly on ENTROPIA (E-LAB-01), ENTRO-AI (E-LAB-02) and ENTRO-CORE (E-LAB-03).
No conflicts of interest declared. All code and data are open-source under MIT License.

How to cite

@software{baladi2026entroengine, author = {Samir Baladi}, title = {ENTRO-ENGINE: Entropy Flow Regulator for Coupled Systems}, year = {2026}, version = {1.0.0}, publisher = {Zenodo}, doi = {10.5281/zenodo.19441032}, url = {https://doi.org/10.5281/zenodo.19441032}, note = {E-LAB-04. Builds on E-LAB-01, E-LAB-02, E-LAB-03} } @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} } @software{baladi2026entrocore, author = {Samir Baladi}, title = {ENTRO-CORE: Regime-Dependent Entropy-Augmented Control}, year = {2026}, version = {0.1.0}, doi = {10.5281/zenodo.19431029}, note = {E-LAB-03} }
"A single engine regulates itself. A fleet of engines requires a coordinator."

Start Exploring

Access the complete framework, validation data, and Python package.