README.md

---
title: CAPT Memory Palace
emoji: 🧠
colorFrom: purple
colorTo: pink
sdk: static
pinned: true
license: mit
short_description: Watch AI think in real-time - 3D cognitive visualization
---

# 🧠 CAPT Memory Palace

<div align="center">

**Watch AI cognition unfold in real-time**

*A 3D visualization of the CAPT (Cortical-AI Processing Technology) cognitive architecture*

[Live Demo](https://knowurknot-capt-memory-palace.static.hf.space) • [GitHub](https://github.com/knowurknottty/biocapt-desktop)

</div>

---

## ✨ What You'll See

When you submit a query, watch the AI "think":

```
Your Query → PULSE (reading) → NEDA (patterns) → HDR (reasoning) 
→ QIPC (competing) → Consensus → IMMU (validation) → NDS (output)
```

### The Experience

| Phase | What Happens | Visual |
|-------|--------------|--------|
| 🔮 **Receiving** | Input is parsed | Purple glow |
| 🔍 **Analyzing** | Pattern recognition | Multiple candidates appear |
| 🧩 **Reasoning** | Concept mapping | Ideas compete |
| 🤝 **Consensus** | Voting/negotiation | One interpretation wins |
| 🛡️ **Validating** | Safety checks | Green confirmation |
| ✨ **Responding** | Output generation | Final answer appears |

---

## 🚀 Get Started

1. **Click "Watch Demo"** — See a simulated cognitive cycle
2. **Enter a query** — Type any question in the input box
3. **Watch the magic** — See modules activate in real-time

### Keyboard Controls

| Key | Action |
|-----|--------|
| `Space` | Toggle cinematic tour |
| `WASD` | Navigate 3D space |
| `M` | Toggle sound |
| `R` | Reset camera |

---

## 🎧 Audio Feedback

Enable sound to hear:
- Module activation tones (different pitch per module)
- Phase transition sounds
- Consensus chime when agreement is reached
- Ambient cognitive drone

---

## 🔌 Connect to Live CAPT

The viewer can connect to a running CAPT symbiote for real data:

```javascript
// In browser console
CAPT_API.configure({ endpoint: 'http://your-capt-server:8000' });
CognitiveSimulator.start(onUpdate, { useRealAPI: true });
```

See [DEPLOY.md](./DEPLOY.md) for full API documentation.

---

## 🛠️ Custom Configurations

Click **📝 Edit** to modify the palace configuration in JSON:

```json
{
  "schemaVersion": "3.0.0",
  "name": "My Research Palace",
  "rooms": [
    {"id": "input", "label": "Input", "type": "input", "color": "#8b5cf6"},
    {"id": "process", "label": "Process", "type": "processing", "color": "#a855f7"}
  ]
}
```

---

## 📊 Supported Modules

| Module | Function |
|--------|----------|
| PULSE | Language processing |
| NEDA | Pattern recognition (event-driven) |
| HMC | Memory encoding (holographic) |
| CIG | Causal inference graph |
| HDR | Hyperdimensional reasoning |
| QIPC | Quantum-inspired consensus |
| ECHO | Episodic memory |
| META | Self-monitoring |
| IMMU | Constitutional validation |
| NDS | Decision synthesis |

---

<div align="center">

**Built with CAPT** — [Learn more about the architecture](https://github.com/knowurknottty/biocapt-desktop)

</div>