Persistent memory infrastructure for AI agents — State Continuity Layer.
Project description
Synapse Layer
RAG retrieves. Synapse remembers.
Persistent memory infrastructure for AI agents — encrypted, governed, and cross-agent.
Why Synapse?
Superpowers proved agents need discipline. Synapse provides the continuity layer that makes that discipline persistent across sessions, tools, and handoffs.
Key Capabilities
| Capability | Description |
|---|---|
| State Continuity | OAuth for AI Memory. Persistent context across sessions and models. |
| Privacy First | Server never sees plaintext. AES-256-GCM client-side encryption. |
| Agent-Native | 30-second install. Built for the MCP ecosystem. |
| Cross-Agent | Share memory between agents via A2A protocol. |
| Trust Quotient | Weighted memory ranking: confidence, recency, and usage. |
Install
pip install synapse-layer
Optional Integrations
pip install synapse-layer[langchain]
pip install synapse-layer[crewai]
Quick Start
Core Client (always available)
from synapse_layer import SynapseA2AClient
async with SynapseA2AClient(api_key="your-key") as client:
# Store a memory
await client.store_memory(
user_id="agent-001",
content="User prefers dark mode and Portuguese.",
source_type="user_input",
confidence=0.95
)
# Recall memories
result = await client.recall_memory(
user_id="agent-001",
query="What are the user preferences?",
limit=10
)
LangChain Adapter (requires langchain-core)
from synapse_layer import SynapseMemory
memory = SynapseMemory(
api_key="your-key",
user_id="agent-001",
input_key="input",
memory_key="history"
)
# Use with any LangChain agent
variables = await memory.load_memory_variables({"input": "What do I know?"})
CrewAI Tools (requires crewai)
from synapse_layer import SynapseStoreMemoryTool, SynapseRecallMemoryTool
store_tool = SynapseStoreMemoryTool(api_key="your-key")
recall_tool = SynapseRecallMemoryTool(api_key="your-key")
# Use as CrewAI tools in your agents
Architecture
┌───────────────────────────────────────────────────────────┐
│ YOUR AGENT │
│ (Claude, GPT-4o, Gemini, etc.) │
└─────────────────────────────┬─────────────────────────────┘
│
┌─────────┴─────────┐
│ synapse-layer │
│ Python SDK │
└─────────┬─────────┘
│
┌─────────────┴─────────────┐
│ SYNAPSE LAYER VAULT │
│ │
│ ✓ AES-256-GCM encrypted │
│ ✓ Server-side at rest │
│ ✓ Per-operation random IV │
│ ✓ Trust Quotient scoring │
└─────────────┬─────────────┘
│
┌───────┴───────┐
│ │
▼ ▼
┌────────────┐ ┌────────────┐
│ Session 2 │ │ Session 3 │
│ (GPT-4o) │ │ (Gemini) │
│ recalls ✓ │ │ recalls ✓ │
└────────────┘ └────────────┘
Security Model
| Layer | Implementation |
|---|---|
| Encryption | AES-256-GCM with per-operation random IV. GCM auth tag validated on every read. |
| Key Management | Keys rotated per environment. Never logged. |
| Privacy | Differential privacy via Gaussian noise on embeddings. |
| Validation | Intent validation pipeline with confidence scoring. |
The server never sees plaintext. All sensitive data is encrypted before storage.
API Reference
SynapseA2AClient
Core async client for the Synapse Layer A2A protocol (JSON-RPC 2.0 over HTTPS).
| Method | Description |
|---|---|
store_memory() |
Store encrypted memory with semantic embedding |
recall_memory() |
Retrieve memories ranked by Trust Quotient |
create_handover() |
Create signed context for cross-agent transfer |
forget_memory() |
Soft-delete specific memories |
SynapseMemory (requires langchain-core)
LangChain BaseMemory adapter for persistent agent memory.
SynapseChatHistory (requires langchain-core)
LangChain BaseChatMessageHistory for persistent chat histories.
CrewAI Tools (requires crewai)
SynapseStoreMemoryTool— Store memoriesSynapseRecallMemoryTool— Recall memoriesSynapseHandoverTool— Cross-agent context transfer
Trust Quotient (TQ)
Memories are ranked using a weighted scoring formula:
TQ = f(confidence, recency, usage)
Higher TQ scores surface the most relevant and reliable memories first. The exact weights are proprietary and dynamically calibrated.
Links
- Website: synapselayer.org
- Forge (Dashboard): forge.synapselayer.org
- Documentation: synapselayer.org/docs
- Issues: GitHub Issues
- MCP Server: Smithery
License
Apache 2.0 — see LICENSE for details.
Synapse Layer
Persistent memory infrastructure for AI agents.
PyPI ·
Website ·
Forge
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file synapse_layer-2.3.2.tar.gz.
File metadata
- Download URL: synapse_layer-2.3.2.tar.gz
- Upload date:
- Size: 16.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b8980c0979afa34005a91118d0cccb7e48e6efa0bf9ed82b7aa61572d98dbb28
|
|
| MD5 |
37eb95f91fa5d5eadc92426d677023f3
|
|
| BLAKE2b-256 |
466d8ad1c65096d5b576c5366b31f700cd3141bb73c09e0bb5ba08115c601494
|
File details
Details for the file synapse_layer-2.3.2-py3-none-any.whl.
File metadata
- Download URL: synapse_layer-2.3.2-py3-none-any.whl
- Upload date:
- Size: 16.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
724757478d16cb1d60f99c1c038229639bedd027650abb08a73c887194e2798c
|
|
| MD5 |
328ba4a3a5f50d7d26b8d3f4616f5982
|
|
| BLAKE2b-256 |
60b682b46fe233d91cb3ef2f671ca6c3ce66f893ff4ca5454bc8b804ebf9f490
|