operon-feedback / README.md
coredipper's picture
docs: improve README with usage instructions
8595c7c verified

A newer version of the Gradio SDK is available: 6.12.0

Upgrade
metadata
title: Operon Feedback Loop Homeostasis
emoji: ⚖️
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 6.5.1
app_file: app.py
pinned: false
license: mit
short_description: Negative feedback loop homeostasis simulation

⚖️ Feedback Loop Homeostasis

Simulate a negative feedback loop driving a value toward a setpoint -- like a thermostat, blood sugar regulation, or any biological homeostasis mechanism.

What to Try

  1. Select a preset from the Preset dropdown (e.g. "Temperature control" or "Underdamped oscillation") and click Run Simulation to see the value converge toward the setpoint over time.
  2. Increase the Gain slider to see faster convergence, or push it too high to trigger oscillation. Raise Damping to suppress overshoot.
  3. Set a Disturbance step and Disturbance magnitude to inject a sudden perturbation mid-simulation and watch the loop reject it.
  4. Compare "Overdamped" vs. "Underdamped" presets to see the tradeoff between speed and stability.

How It Works

The NegativeFeedbackLoop computes a correction at each step based on the error (distance from setpoint), scaled by gain and damped to prevent oscillation. This mirrors how biological systems maintain homeostasis -- applying proportional corrections that self-regulate toward equilibrium.

Learn More

GitHub | PyPI | Paper