RSC Open Demo — Community Edition (Apache-2.0)

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

---

Quick start (Python)

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

Quick start (Docker)

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

---

Files

• 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

License

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

Notes

• 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.