operon-oscillator / README.md
coredipper's picture
docs: improve README with usage instructions
4bc20c9 verified

A newer version of the Gradio SDK is available: 6.12.0

Upgrade
metadata
title: Operon Biological Oscillators
emoji: πŸ”ƒ
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 6.5.1
app_file: app.py
pinned: false
license: mit
short_description: Biological oscillator patterns and waveform visualization

πŸ”ƒ Biological Oscillator Patterns

Visualize oscillator waveforms and biological phase structures -- the timing mechanisms that drive periodic maintenance, heartbeat monitoring, and cell cycle control in Operon agents.

What to Try

  1. Open the Waveform Explorer tab, select a waveform type from the dropdown (Sine, Square, Sawtooth, Triangle, or Pulse), adjust Frequency, Amplitude, and Damping sliders, and click Generate to see the waveform.
  2. Try the "Damped sine" preset to see how oscillations decay over time, or "Fast triangle" for rapid cycling.
  3. Switch to the Biological Oscillators tab and explore Circadian (day/night phases), Heartbeat (BPM-based), and Cell Cycle (G1/S/G2/M phase breakdowns) patterns.

How It Works

Waveforms are computed mathematically from sine-based functions with configurable damping. Biological oscillators map these waveforms to real-world phase structures -- circadian rhythms, heartbeat intervals, and cell division cycles -- providing the timing backbone for Operon's scheduled maintenance and lifecycle management.

Learn More

GitHub | PyPI | Paper