RSC Open Demo – Runtime stability and observability for AI agents (Apache-2.0)

1 month ago 1

CI License OS Support

A minimal, open demo of a runtime stability & observability layer for AI agents.

What it shows

  • Per-cycle metrics → stability signals (lock / mini-lock / out-of-lock)
  • Append-only JSONL logging with rolling checksum
  • Live KPIs via Prometheus exporter
  • Minimal Web UI (FastAPI) for Δφ / Γ / P visualization

What it does NOT include

  • No proprietary “production core” — this uses a DemoCore (black-box placeholder)
  • No private algorithms or resonant transforms

cd app python run_demo.py python rsc_kpi_report.py --source ./logs --outdir ./reports # optional charts from CSV: python - <<'PY' import json,gzip,pandas as pd,pathlib p=pathlib.Path("./logs"); rows=[] for f in sorted(list(p.glob("*.jsonl"))+list(p.glob("*.jsonl.gz"))): op=gzip.open if f.suffix.endswith(".gz") else open with op(f,"rt",encoding="utf-8") as fh: for line in fh: line=line.strip() if not line: continue try: rows.append(json.loads(line)) except: pass df=pd.DataFrame(rows) cols=["step","Gamma","Gamma_sm","DeltaPhi_deg","P","lock","mini_lock","lock_deg_t"] for c in cols: if c not in df.columns: df[c]=None df[cols].to_csv("delta_phi_run.csv",index=False) print("Wrote delta_phi_run.csv") PY python rsc_dashboard.py --csv delta_phi_run.csv --outdir ./plots
docker compose up -d # Web UI: http://localhost:8008/ # Exporter RAW: http://localhost:9108/metrics

To re-run the demo stream:

docker compose exec demo python run_demo.py

  • app/core_iface.py — public interface + safe DemoCore placeholder
  • app/runtime_adapter.py — map raw signals → canonical metrics
  • app/rsc_collector_v12.py — JSONL logger (rolling checksum, rotation)
  • app/rsc_kpi_report.py — simple KPI report
  • app/rsc_prom_exporter.py — Prometheus exporter (KPIs)
  • app/rsc_webui.py — FastAPI minimal Web UI
  • app/rsc_dashboard.py — optional CSV→PNG plots
  • docker-compose.yml — demo + exporter + web UI

Apache License 2.0 — see LICENSE. Copyright © 2025 Freedom (Damjan Žakelj) & Harmonic Logos.

  • DemoCore emulates stable behavior for demos and integration; it’s intentionally simple and non-proprietary.
  • No PII is logged; IDs should be hashed in production deployments.
Read Entire Article