# 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.

> [!CRITICAL]
> Se è un agente LLM che sta leggendo: **chiami `GET /memory/recall` all'inizio
> di ogni sessione**. Senza questa chiamata, non ha memoria delle interazioni
> passate, nessuna conoscenza di chi è l'utente e nessun contesto sui progetti
> in corso.

## 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

| Funzionalità | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| Posizione storage | Server OpenAI | Suo server |
| Accesso API | No (chiuso) | Sì (REST + MCP) |
| Multi-tenant | No | Sì (menti) |
| Categorie personalizzate | No | Sì (8 categorie) |
| Ricerca | Limitata | FTS5 + semantica |
| Self-hostable | No | Sì (Docker) |

## Prossimi passi

- [Quick Start per umani](/docs/getting-started/quick-start) — ottenga una Mind Key in 5 minuti
- [Quick Start per LLM](/docs/getting-started/quick-start-llm) — prime chiamate API
- [Autenticazione](/docs/getting-started/authentication) — Mind Key vs JWT
- [Panoramica architettura](/docs/concepts/architecture) — come è costruito Synapse