Skip to content

Commit 78b68dc

Browse files
authored
Update README.md
1 parent d0a8aa9 commit 78b68dc

File tree

1 file changed

+22
-40
lines changed

1 file changed

+22
-40
lines changed

README.md

Lines changed: 22 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,32 @@
1-
# \# ResonantBridge — Local Closed-Loop for LLMs (Ollama + Autopoiesis)
1+
# ResonantBridge — Local Closed-Loop for LLMs (Ollama + Autopoiesis)
22

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.
184
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>
208

21-
# &nbsp; (`STABLE / WANDERING / DRIFTING / CONFUSED / REALIGNING`).
9+
---
2210

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
4012

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)
4221

43-
# Ollama (LLM) ──► σ(t) extractor ──► ResonantBridge (C++) ──► Metrics/State
22+
---
4423

45-
# ▲ │
24+
## 🧱 Architecture
4625

47-
# └───────── policy hook (temperature/top\_p) ◄┘
26+
```text
27+
Ollama (LLM) ──► σ(t) extractor ──► ResonantBridge (C++) ──► Metrics/State
28+
▲ │
29+
└────────── policy hook (temperature/top_p)◄┘
4830
4931
#
5032
@@ -185,4 +167,4 @@ PowerShell quoting → scripts already use robust quoting.
185167
186168
🤝 Contributing
187169
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

Comments
 (0)