A reproducible Python coherence simulator and browser reflection tool with an explicit ethical guardrail.
Scope: Kairos Echo is a poetic, contemplative research tool—not therapy, meditation instruction, spiritual authority, or a measurement of consciousness.
- Deterministic simulations with seeded random-number generation
- Coherence, distortion, and stability dynamics
- A Guardian Veto™ that limits outward action when simulated coherence is low
- Trekchö- and Tögal-inspired reflection prompts
- CLI modes for runs, summaries, logging, and reflection
- A standalone browser interface in
kairos-echo.html - Optional Plotly visualization when Plotly is installed
git clone https://github.com/aruintelligence/kairos-echo-reflection-tool.git
cd kairos-echo-reflection-tool
python kairos_echo.py --mode run --steps 500 --seed 42
python kairos_echo.py --mode summary
python kairos_echo.py --mode togalFor dashboard mode:
python -m pip install plotly
python kairos_echo.py --mode dashboard --save-html dashboard.htmlYou can also open kairos-echo.html directly in a modern browser.
Use a fixed --seed to reproduce a trajectory. Treat the values as simulator state—not clinical, psychological, or spiritual measurements.
Released under the MIT License. Dzogchen terms belong to living religious traditions and are used here respectfully as inspiration, without claiming lineage or authority.