mindfry 1.6.2

The World's First Ephemeral Graph Database - A Cognitive DB Engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

# MindFry


**A Subjective Biological Memory Substrate**

> _"Databases store data. MindFry_ **_feels_** _it."_

[![License: BSL](https://img.shields.io/badge/License-BSL--1.1-blue.svg)](LICENSE)
[![Tests](https://img.shields.io/badge/tests-74%20passing-brightgreen)]()
[![Version](https://img.shields.io/badge/version-1.6.0-blue)]()

---

> ⚠️ **EXPERIMENTAL:** MindFry is currently in active R&D. The API is volatile. It simulates biological memory processes which may result in data inhibition (data loss from the user's perspective) based on the system's "mood". **Do not use for banking.**

---

## What Makes This Different?


Traditional databases are **objective** — they store exactly what you give them, forever (or until you delete it).

MindFry is **subjective** — it processes data through a simulated cognitive layer that can:

- **Forget** data that isn't accessed (organic decay)
- **Suppress** data it finds antagonistic (mood-based inhibition)
- **Strengthen** frequently accessed data (Hebbian learning)
- **Propagate** stimulation through neural bonds (synaptic chains)

## 🧬 Core Principles


### 🧠 Tri-Cortex Architecture


Decisions are made using **Balanced Ternary Logic** (Setun):

- `+1` = True / Excitation
- `0` = Unknown / Neutral
- `-1` = False / Inhibition

The database has a **Personality Octet** (8 dimensions) and a **Mood** that affects query results.

### ❤️ Mood & Personality


A depressed database behaves differently than a euphoric one:

- **High Mood** → Lower consciousness threshold → More data accessible
- **Low Mood** → Higher threshold → Data feels "distant"

### 🕸️ Synaptic Propagation


When you `stimulate("A")`:

```
A (+1.0) → B (+0.5) → C (+0.25) → ... (damped)
```

Touch one memory, its neighbors tremble.

### 💾 Resurrection


Shutdown and restart. The database remembers:

- Its mood
- Its personality
- All lineages and bonds

## Quick Start


### 🐳 Docker (Recommended)


```bash
docker run -d -p 9527:9527 ghcr.io/laphilosophia/mindfry:latest
```

### From Source


```bash
# Clone

git clone https://github.com/laphilosophia/mindfry.git
cd mindfry

# Run server

cargo run --release --bin mindfry-server

# In another terminal

cargo run --bin mfcli -- ping
cargo run --bin mfcli -- create fire 0.9
cargo run --bin mfcli -- stimulate fire 1.0
cargo run --bin mfcli -- stats
```

## SDK


```bash
npm install mindfry
```

```typescript
import { MindFry } from 'mindfry'

const brain = new MindFry({ host: 'localhost', port: 9527 })
await brain.connect()

// Touch one memory...
await brain.lineage.stimulate({ key: 'trauma', delta: 1.0 })

// ...and its neighbors tremble
const associated = await brain.lineage.get('fear')
console.log(associated.energy) // Increased by propagation
```

## Status


| Component            | Status     |
| -------------------- | ---------- |
| Core Engine          | ✅ Working |
| SDK (TypeScript)     | ✅ Working |
| Persistence          | ✅ Working |
| Auto-Propagation     | ✅ Working |
| OQL (Query Language) | 🚧 Planned |
| CEREBRO (GUI)        | 🚧 Planned |
| Documentation Site   | 🚧 Planned |

## License


[BSL 1.1](LICENSE) © [Erdem Arslan](https://github.com/laphilosophia)

---

_"If you're not embarrassed by the first version of your product, you've launched too late."_ — Reid Hoffman