🧠 Synapse Protocol

Distributed, Bio-Mimetic AI Memory System

🎯 Vision

Synapse Protocol is a distributed AI memory system that runs locally on user devices (PC/Mobile). It uses a "Neoteny" approach - a small core model that grows and learns continuously without catastrophic forgetting.

Core Philosophy

• Human-Centric: User data is the currency. Privacy is paramount (Local-First).
• Genesis Block: An immutable ethical vector ("Do no harm") filters all AI actions.
• Bio-Mimetic: Memory consolidation mimics biological sleep/dream cycles.
• One Brain, Many Hats: Single model instance with LoRA adapter swapping.

🏗️ Architecture

Hexagonal Architecture (Ports & Adapters)
├── synapse-core    # Domain logic (PURE - no external deps)
├── synapse-infra   # Infrastructure adapters
└── synapse-cli     # CLI application

🚀 Quick Start

Prerequisites

1. Rust (2021 edition or later)
2. Protocol Buffers Compiler (protoc)

   # Windows (Chocolatey)
   choco install protoc
   
   # macOS (Homebrew)
   brew install protobuf
   
   # Ubuntu/Debian
   sudo apt install protobuf-compiler
   
   # Or download from:
   # https://github.com/protocolbuffers/protobuf/releases

Build

# Clone
git clone https://github.com/YOUR_ORG/synapse-protocol
cd synapse-protocol

# Build
cargo build --release

# Run CLI
cargo run -p synapse-cli -- --help

📦 Project Structure

synapse-protocol/
├── .ai-core/                # AI context (Architecture, Agent Index)
├── .github/issues/         # Issue tracking (Git-Core Protocol)
├── crates/
│   ├── synapse-core/       # Domain layer
│   ├── synapse-infra/      # Infrastructure layer
│   └── synapse-cli/        # CLI application
├── apps/desktop/           # Tauri + Svelte UI
└── models/                 # ONNX/GGUF models

🛠️ Tech Stack

Component	Technology
Language	Rust 2021
Vector Store	LanceDB
Buffer Store	Sled
AI Inference	Candle (RWKV) + ORT
Embeddings	all-MiniLM-L6-v2
P2P Network	Libp2p
Desktop UI	Tauri v2 + Svelte 5

📋 Development

This project follows the Git-Core Protocol:

• State: GitHub Issues (not TODO.md files)
• Commits: Conventional Commits
• Architecture: .✨/ARCHITECTURE.md

Agent Assignments

• Core/Infra (Rust): Copilot (Claude Opus/Sonnet)
• UI/UX (Tauri+Svelte): Jules (Google)

📚 Research & References

Crystal Logic (Latent Space Communication)

Synapse Protocol implements Crystal Logic, a semantic compression paradigm inspired by the VL-JEPA paper. Instead of transmitting raw data, we transmit "photonic" coordinates to reconstruct content.

Core Components:

• HoloPacket: The atomic unit carrying refraction_index, polarization_signature, and temporal_phase.
• HologramStreamEncoder: Sender-side logic that calculates semantic variance between frames.
• HologramStreamDecoder: Receiver-side logic that skips decoding if semantic stability is high (Selective Decoding).

Framework: This logic is formalized in the photon-core research framework, a Rust-based simulation for 5D Optical Data Encoding.

OCR: DeepSeek-OCR

• Paper: arxiv:2510.18234 - "Contexts Optical Compression"
• Key: DeepEncoder (SAM+CLIP) with 16x compression, multi-resolution (64-400 tokens), 96%+ accuracy @ 10x compression
• Application: Window→global attention for HolographicRetina, Genesis-guided denoising

---

⚖️ License

Dual Licensed:

• AGPLv3 for open source projects
• Commercial License for proprietary/closed-source use

What this means:

• ✅ Free to use, modify, and distribute (must keep open source)
• ✅ Commercial use allowed IF you open-source your entire application

See LICENSE for full AGPLv3 text.

---

Why AGPLv3? We believe in open innovation while protecting against exploitation. Companies that benefit from our work should either contribute back to the community (open source) or support development (commercial license).

---

Built with 🧠 by South West Labs

compasión y empatía 🗝️