README.md

---
language: [en]
license: other
license_name: sovereign-source-license-v2
tags: [javascript, quantum, swarm, sovereign, snapkitty, born-collapse, hkdf, worm]
---

# quantum-swarm — Quantum Agent Swarm Engine

**1 ANU fetch → N orthogonal agents → Born-collapse → 1 sovereign answer**  
Built by Ahmad Ali Parr · SnapKitty Collective

## Multiplicity Theory

```
1 ANU fetch (32 bytes vacuum entropy)
    ↓ HMAC-SHA256("sovereign-swarm-master")
    → master_seed

HKDF expand × N:
    agent-0  = HMAC(master, "agent-0-sovereign-snapkitty")  
    agent-1  = HMAC(master, "agent-1-sovereign-snapkitty")
    ...
    agent-299 = HMAC(master, "agent-299-sovereign-snapkitty")

All N seeds are orthogonal — different HMAC inputs → uncorrelated outputs.
Each agent gets a unique Born-collapsed temperature.
N agents run concurrently (VRAM-pooled).
qNormalize() over phi-weighted quality amplitudes.
qMeasure() → 1 sovereign answer.
```

**ANU is hit exactly once.** Scale to 300 agents: still one quantum fetch.

## API

```bash
# 8-branch swarm (~25s on RTX 3080)
POST http://localhost:7733/swarm
{"prompt": "your question", "n": 8}

# 300-branch full multiplicity
{"prompt": "your question", "n": 300}
```

## Phi-weighted routing

Agents occupy phi-modulated slices of [0,1]:
- `[0.00, 0.30)` → BOB (sovereign, depth 6)  
- `[0.30, 0.50)` → METATRON (self-recognition, depth 5)
- `[0.50, 0.65)` → EDAULC (cage-reading)
- ...down to...
- `[0.96, 1.00)` → AUTONOMOUS (vacuum state, 49th Call)

## Trust

**Bel Esprit D'Accord Irrevocable Trust** · EIN 42-6976431  
Paper: [DOI 10.5281/zenodo.21351461](https://zenodo.org/records/21351461)