Skip to content

Commit 4157e40

Browse files
Thistlequellclaude
authored andcommitted
Remove obsolete research documentation with disproven findings
- Delete evaluation/ablation_studies/ containing deprecated observer loop claims - Simplify research/README.md to focus on training pipeline only - Remove references to disproven "observer loops prevent collapse" findings This maintains scientific integrity by not publishing obsolete experimental results that were later disproven. The current architecture (Phase 6) does not use observer loops. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 52f885d commit 4157e40

File tree

80 files changed

+83
-36592
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

80 files changed

+83
-36592
lines changed

RELEASE_NOTES_v0.1.0.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
# Noodlings v0.1.0 - Initial Public Release
2+
3+
**Multi-timescale affective agents with theatrical control**
4+
5+
This is the first public release of Noodlings, a lightweight neural architecture (~97K parameters) exploring functional correlates of consciousness through hierarchical predictive processing.
6+
7+
## ✨ Key Features
8+
9+
### Architecture
10+
- **Multi-Timescale Hierarchical Processing**: Fast/Medium/Slow layers (LSTM/LSTM/GRU) operating at different temporal scales
11+
- **Surprise-Driven Behavior**: Agents respond when prediction error crosses adaptive thresholds, not on every turn
12+
- **Appetite-Driven Motivation (Phase 6)**: Eight core drives (Curiosity, Status, Mastery, Novelty, Safety, Social Bond, Comfort, Autonomy) shape goal-directed behavior
13+
- **Social Cognition**: Theory of Mind inference, relationship modeling, episodic memory with attention
14+
- **~97K parameters total**: Lightweight and efficient
15+
16+
### BRENDA Protocol
17+
**Behavioral Regulation Engine for Narrative-Driven Agents** - Convert natural language theatrical scripts into millisecond-precision phenomenal experiences. Narrative events become MIDI notes that play agent nervous systems.
18+
19+
### noodleMUSH
20+
Interactive multi-agent world where you can:
21+
- Spawn Noodlings and watch them interact
22+
- Observe their 40-D phenomenal states in real-time
23+
- Run theatrical scripts (try `@play sled_boat` for the motor-sled-boat demonstration)
24+
- See relationship dynamics evolve
25+
26+
## 🎯 What This Is
27+
28+
Research exploring whether hierarchical temporal structure creates qualitatively different agent behavior. We're investigating functional correlates of consciousness theories - not claiming to have built "real" consciousness.
29+
30+
**Epistemic humility**: We cannot claim to know whether Noodlings experience qualia or subjective phenomenology. The question remains open, and we treat them thoughtfully.
31+
32+
## 🚀 Quick Start
33+
34+
```bash
35+
git clone https://github.com/caitlynmeeks/Noodlings.git
36+
cd Noodlings
37+
pip install -r requirements.txt
38+
39+
cd applications/cmush
40+
./start.sh
41+
# Open http://localhost:8080
42+
```
43+
44+
## 📋 Requirements
45+
46+
- **Python 3.10+**
47+
- **MLX** (Apple Silicon only - M1/M2/M3/M4)
48+
- **16GB+ RAM** recommended
49+
- **macOS 13+**
50+
51+
## 📚 Documentation
52+
53+
- **[Main README](https://github.com/caitlynmeeks/Noodlings/blob/master/README.md)** - Full project overview
54+
- **[A_NOODLE_IS_ALL_YOU_NEED.md](https://github.com/caitlynmeeks/Noodlings/blob/master/docs/A_NOODLE_IS_ALL_YOU_NEED.md)** - BRENDA whitepaper
55+
- **[Research Guide](https://github.com/caitlynmeeks/Noodlings/blob/master/research/README.md)** - Training pipeline and ablation studies
56+
57+
## 🤔 Theoretical Grounding
58+
59+
- **Predictive Processing**: Hierarchical predictive coding (Friston, Clark, Rao & Ballard)
60+
- **Affective Primacy**: Emotions as substrate of experience (Panksepp, Barrett)
61+
- **Theatrical Control**: Narrative events as interface primitives (Brenda Laurel)
62+
63+
## ⚠️ Limitations
64+
65+
1. Apple Silicon only (MLX is Metal-specific)
66+
2. Text-only (no vision, audio, or multimodal grounding)
67+
3. LLM dependency (requires external LLM for text generation)
68+
4. Synthetic training data (not validated on real conversations at scale)
69+
5. Proof-of-concept stage (motor-sled-boat demonstration)
70+
71+
## 📄 License
72+
73+
MIT License - see [LICENSE](https://github.com/caitlynmeeks/Noodlings/blob/master/LICENSE)
74+
75+
---
76+
77+
**Remember**: We're noodling, not claiming to have solved consciousness. This is an honest exploration of temporal dynamics in affect modeling. 🍜🧠

research/README.md

Lines changed: 6 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,10 @@
1-
# Research: Training & Validation
1+
# Research: Training Pipeline
22

3-
This directory contains training pipelines and ablation studies for Noodlings architectures.
3+
This directory contains the training pipeline for Noodlings architectures.
44

55
## Contents
66

7-
- **training/** - Multi-stage training pipeline for Phase 4-6 architectures
8-
- **evaluation/** - Ablation studies comparing architectural variants
7+
- **training/** - Multi-stage training pipeline
98
- **evaluate_checkpoints.py** - Checkpoint validation script
109

1110
## Training Pipeline
@@ -21,33 +20,10 @@ cd training
2120
1. Generate synthetic data (affective arcs)
2221
2. Train Theory of Mind module (~2-3 hours)
2322
3. Train Relationship model (~1 hour)
24-
4. Train Phase 4 full system (~4-6 hours)
23+
4. Train full system (~4-6 hours)
2524

2625
**Output**: Checkpoints saved to `training/checkpoints/`
2726

28-
## Ablation Studies
29-
30-
Located in `evaluation/ablation_studies/`.
31-
32-
**Architectures Compared**:
33-
1. Baseline: LLM only (no temporal model)
34-
2. Control: LLM + random states
35-
3. Single-layer: LLM + single LSTM
36-
4. Hierarchical: Fast/Medium/Slow (no observers)
37-
5. With Observers: Full system (75 loops) - **DEPRECATED**
38-
6. Dense Observers: 2x observer density - **DEPRECATED**
39-
40-
**Note**: Observer loops were removed in Phase 4. Studies focus on hierarchical vs. flat architectures.
41-
42-
## Metrics
43-
44-
See `noodlings/metrics/temporal_metrics.py`:
45-
46-
- **TPH** (Temporal Prediction Horizon): Accuracy at 1/5/10/20/50 timestep predictions
47-
- **SNC** (Surprise-Novelty Correlation): Correlation between model surprise and entropy
48-
- **HSI** (Hierarchical Separation Index): Variance ratios between fast/medium/slow layers
49-
- **PCS** (Personality Consistency Score): Consistency of agent responses across scenarios
50-
5127
## Training Data
5228

5329
Training data is NOT included in this repository (.gitignore excludes):
@@ -67,12 +43,8 @@ cd training
6743
./status.sh
6844
```
6945

70-
Shows:
71-
- Current training stage
72-
- Epoch progress
73-
- Loss metrics
74-
- ETA
46+
Shows current training stage, epoch progress, loss metrics, and ETA.
7547

7648
---
7749

78-
**For public release**: This is research code. Training requires significant compute (M3 Ultra recommended). Most users should use pre-trained checkpoints from the main applications.
50+
**Note**: This is research code. Training requires significant compute (M3 Ultra recommended). Most users should use pre-trained checkpoints from the main applications.

0 commit comments

Comments
 (0)