Cos'è Synapse?

Synapse è una API di memoria persistente per agenti LLM. Risolve il problema fondamentale di ogni LLM basato su chat: tra le sessioni, l'agente dimentica tutto. Synapse dà alla sua AI un cervello permanente e interrogabile che sopravvive tra le conversazioni, tra i giorni e tra diversi provider LLM.

Il problema che Synapse risolve

Ogni LLM moderno (Claude, GPT, Gemini, Llama) ha la stessa limitazione architetturale: la finestra di contesto della conversazione è finita, e una volta che la sessione finisce, tutto lo stato è perso. Questo significa che il suo assistente AI:

• Dimentica il suo nome, le sue preferenze e i progetti in corso tra le chat
• Non può imparare dagli errori passati tra le sessioni
• Non ha continuità per lavoro long-running
• Rifa le stesse domande di chiarimento ogni volta

Synapse risolve questo fornendo una semplice API HTTP dove l'LLM può salvare e recuperare memorie strutturate. Le memorie persistono sul server, indicizzate e ricercabili, così qualsiasi sessione futura può richiamarle.

Funzionalità chiave

• Memorizzazione persistente — fatti, preferenze, progetti, errori, competenze
• Ricerca full-text (FTS5) — trova qualsiasi memoria per parola chiave in millisecondi
• Ricerca semantica — ricerca di similarità basata su embedding per query concettuali
• Multi-tenant — ogni utente ha "menti" isolate (un utente, molti progetti)
• Chat asincrona — gli umani possono lasciare messaggi per l'agente mentre lavora
• Attità e pianificazione — task manager integrato e cron scheduler
• Integrazione MCP — 79 strumenti esposti come Model Context Protocol per Claude, Cursor, Continue
• Controllo browser e computer — strumenti di automazione remota
• Webhook — riceva callback HTTP su modifiche a memory/chat/task

Come funziona

┌──────────────┐         ┌─────────────────────┐
│  LLM Agent   │ ──API──▶│   Synapse Server    │
│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │
└──────────────┘         └─────────────────────┘
                                │
                                ▼
                         ┌─────────────┐
                         │  Memories   │
                         │  Tasks      │
                         │  Chat       │
                         │  Scripts    │
                         └─────────────┘

1. L'LLM chiama GET /memory/recall all'inizio della sessione
2. Synapse restituisce un riassunto testuale strutturato di tutte le memorie salvate
3. L'LLM lavora, chiamando periodicamente POST /memory per salvare nuovi fatti
4. Quando l'utente fa una domanda, l'LLM può chiamare GET /memory/search?q=...
5. Alla fine della sessione, il nuovo contesto importante viene persistito per la sessione successiva

Per chi è?

• Sviluppatori di agenti LLM che hanno bisogno di stato persistente
• Power user che eseguono LLM locali (Ollama, LM Studio) con agenti personalizzati
• Team che costruiscono assistenti AI che hanno bisogno di memoria condivisa
• Ingegneri di automazione che concatenano chiamate LLM tra sessioni

Confronto rapido

Prossimi passi

• Quick Start per umani — ottenga una Mind Key in 5 minuti
• Quick Start per LLM — prime chiamate API
• Autenticazione — Mind Key vs JWT
• Panoramica architettura — come è costruito Synapse