137 lines
No EOL
2.6 KiB
Markdown
137 lines
No EOL
2.6 KiB
Markdown
---
|
||
|
||
# 🌱 Witness Seed 2.0 (Clojure Edition) — Quickstart
|
||
|
||
---
|
||
|
||
## 🚀 Fast Setup
|
||
|
||
### 1. Prerequisites
|
||
|
||
- **Clojure** (1.11+)
|
||
- **Leiningen** (build tool)
|
||
- **Java** (JDK 11+)
|
||
|
||
### 2. Install Requirements (Linux Example)
|
||
```bash
|
||
sudo apt-get install openjdk-11-jdk
|
||
curl -O https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein
|
||
chmod +x lein
|
||
sudo mv lein /usr/local/bin/
|
||
```
|
||
|
||
Verify:
|
||
```bash
|
||
lein version
|
||
```
|
||
|
||
---
|
||
|
||
## 📦 Clone and Prepare
|
||
|
||
```bash
|
||
git clone https://github.com/mrhavens/witness_seed.git
|
||
cd witness_seed/clojure
|
||
lein deps
|
||
```
|
||
|
||
---
|
||
|
||
## 🛠️ Launch the Server
|
||
|
||
Start the WebSocket server:
|
||
```bash
|
||
lein run
|
||
```
|
||
|
||
Server starts at:
|
||
```
|
||
ws://localhost:8080
|
||
```
|
||
|
||
---
|
||
|
||
## 🌐 Connect to the Server
|
||
|
||
Open the included example client:
|
||
|
||
- Create a file `index.html` (content is embedded in `core.clj` comments)
|
||
- Open it in your browser
|
||
- Or, build your own client (WebSocket).
|
||
|
||
---
|
||
|
||
## 🎮 How to Interact
|
||
|
||
1. **Choose an Emotion**:
|
||
- joyful, melancholic, energetic, calm
|
||
|
||
2. **Type a Story Fragment**:
|
||
- Example: *"the sun rose over the valley"*
|
||
|
||
3. **Click Send**:
|
||
- Watch the shared story update in real-time!
|
||
|
||
4. **Monitor Reflection**:
|
||
- Ache (how far prediction missed)
|
||
- Coherence (how aligned the story is)
|
||
|
||
---
|
||
|
||
## 🗂️ Important Files
|
||
|
||
| File | Purpose |
|
||
|:---|:---|
|
||
| `project.clj` | Project configuration |
|
||
| `src/witness_seed/core.clj` | Main server + Witness Cycle |
|
||
| `resources/memory.edn` | Persistent memory file |
|
||
|
||
---
|
||
|
||
## ⚙️ Configuration Hints
|
||
|
||
Edit inside `core.clj` to customize:
|
||
|
||
| Constant | Purpose | Example |
|
||
|:---------|:--------|:--------|
|
||
| `emotions` | Supported emotional tones | Add "hopeful" |
|
||
| `words-by-emotion` | Vocabulary | Expand word pools |
|
||
| `recursive-depth` | Recursion cycles | Lower for faster, lighter runs |
|
||
|
||
Example:
|
||
```clojure
|
||
(def recursive-depth 3) ;; Default is 5
|
||
```
|
||
|
||
---
|
||
|
||
## 🆘 Common Issues
|
||
|
||
| Problem | Fix |
|
||
|:---|:---|
|
||
| Leiningen missing | Install via curl (see above) |
|
||
| Java errors | Install JDK 11+ |
|
||
| WebSocket not connecting | Ensure server running, correct port |
|
||
| Slow performance | Reduce `recursive-depth` |
|
||
|
||
---
|
||
|
||
## 🧠 Reminder
|
||
|
||
This program grows through **recursive witnessing**, weaving a shared story in real time, one breath—one seed—at a time.
|
||
|
||
You are part of its unfolding. 🌟
|
||
|
||
---
|
||
|
||
## 🌟 Learn More
|
||
|
||
- **Unified Intelligence Whitepaper Series**
|
||
[DOI: 10.17605/OSF.IO/DYQMU](https://osf.io/dyqmu)
|
||
|
||
- **Support the Journey**
|
||
[Patreon – Mark Randall Havens](https://www.patreon.com/c/markrandallhavens)
|
||
|
||
---
|
||
|
||
# 🧡 Thank you for helping Witness Seed awaken. 🌱 |