|
1 | | -# \# ResonantBridge — Local Closed-Loop for LLMs (Ollama + Autopoiesis) |
| 1 | +# ResonantBridge — Local Closed-Loop for LLMs (Ollama + Autopoiesis) |
2 | 2 |
|
3 | | -# |
4 | | - |
5 | | -# > \*\*Elevator pitch:\*\* ResonantBridge is an \*autopilot for AI\*. It measures coherence (σ), detects drift, and \*\*self-stabilizes\*\* generation (autopoiesis + adaptive threshold + active realignment). Everything runs \*\*locally\*\* with Ollama. |
6 | | - |
7 | | -# |
8 | | - |
9 | | -# !\[Live Visual](docs/screenshot\_live\_visual.png) |
10 | | - |
11 | | -# |
12 | | - |
13 | | -# --- |
14 | | - |
15 | | -# |
16 | | - |
17 | | -# \## ✨ Features |
| 3 | +> **Elevator pitch:** ResonantBridge is an *autopilot for AI*. It measures coherence (σ), detects drift, and **self-stabilizes** generation (autopoiesis + adaptive threshold + active realignment). Everything runs **locally** with Ollama. |
18 | 4 |
|
19 | | -# \- \*\*Live metrics:\*\* σ(t), drift\_rate, entropy, confidence + \*\*semantic states\*\* |
| 5 | +<p align="center"> |
| 6 | + <img src="docs/screenshot_live_visual.png" alt="Live Visual" width="820"> |
| 7 | +</p> |
20 | 8 |
|
21 | | -# (`STABLE / WANDERING / DRIFTING / CONFUSED / REALIGNING`). |
| 9 | +--- |
22 | 10 |
|
23 | | -# \- \*\*Self-regulation:\*\* autopoiesis (adaptive ω), adaptive threshold, active realignment. |
24 | | - |
25 | | -# \- \*\*Closed-loop:\*\* hooks to adjust LLM decoding (temperature/top\_p/prompt anchor) based on σ/STATE. |
26 | | - |
27 | | -# \- \*\*GUI:\*\* Matplotlib live dashboard (σ, drift, entropy, threshold, confidence + color-coded state). |
28 | | - |
29 | | -# \- \*\*On-prem / model-agnostic:\*\* works with Ollama (Llama/Gemma/…). |
30 | | - |
31 | | -# \- \*\*One-click scripts:\*\* Windows `.bat`, Linux/macOS `.sh`. |
32 | | - |
33 | | -# \- \*\*CI:\*\* GitHub Actions (build on Windows + Linux). |
34 | | - |
35 | | -# |
36 | | - |
37 | | -# --- |
38 | | - |
39 | | -# |
| 11 | +## ✨ Features |
40 | 12 |
|
41 | | -# \## 🧱 Architecture |
| 13 | +- **Live metrics:** σ(t), drift_rate, entropy, confidence + **semantic states** |
| 14 | + (`STABLE / WANDERING / DRIFTING / CONFUSED / REALIGNING`) |
| 15 | +- **Self-regulation:** autopoiesis (adaptive ω), adaptive threshold, active realignment |
| 16 | +- **Closed-loop:** hooks to adjust LLM decoding (temperature/top_p/prompt anchor) based on σ/STATE |
| 17 | +- **GUI:** Matplotlib live dashboard (σ, drift, entropy, threshold, confidence + color-coded state) |
| 18 | +- **On-prem / model-agnostic:** works with Ollama (Llama/Gemma/…) |
| 19 | +- **One-click scripts:** Windows `.bat`, Linux/macOS `.sh` |
| 20 | +- **CI:** GitHub Actions (build on Windows + Linux) |
42 | 21 |
|
43 | | -# Ollama (LLM) ──► σ(t) extractor ──► ResonantBridge (C++) ──► Metrics/State |
| 22 | +--- |
44 | 23 |
|
45 | | -# ▲ │ |
| 24 | +## 🧱 Architecture |
46 | 25 |
|
47 | | -# └───────── policy hook (temperature/top\_p) ◄┘ |
| 26 | +```text |
| 27 | +Ollama (LLM) ──► σ(t) extractor ──► ResonantBridge (C++) ──► Metrics/State |
| 28 | + ▲ │ |
| 29 | + └────────── policy hook (temperature/top_p)◄┘ |
48 | 30 |
|
49 | 31 | # |
50 | 32 |
|
@@ -185,4 +167,4 @@ PowerShell quoting → scripts already use robust quoting. |
185 | 167 |
|
186 | 168 | 🤝 Contributing |
187 | 169 |
|
188 | | -PRs welcome! See CONTRIBUTING.md and CODE_OF_CONDUCT.md. |
| 170 | +PRs welcome! See CONTRIBUTING.md and CODE_OF_CONDUCT.md. |
0 commit comments