# FAQ generale

Domande comuni su Synapse.

## Cos'è Synapse?

Synapse è una API di memoria persistente per agenti LLM. Dà al suo assistente
AI un cervello permanente e interrogabile che sopravvive tra le sessioni.
Invece di dimenticare tutto quando la chat si chiude, l'LLM salva e recupera
le memorie tramite una semplice API HTTP.

**Scopra di più:** [Cos'è Synapse?](/docs/getting-started/what-is-synapse)

## Per chi è Synapse?

- **Sviluppatori di agenti LLM** che hanno bisogno di stato persistente
- **Power user** che eseguono LLM locali con agenti personalizzati
- **Team** che costruiscono assistenti AI con memoria condivisa
- **Ingegneri di automazione** che concatenano chiamate LLM tra sessioni

## Synapse è gratuito?

Synapse è ospitato su <https://synapse.schaefer.zone> e gratuito per uso
personale. Per il self-hosting, veda il [repo](https://gitlab.com/schaefer-services/synapse).

## In cosa differisce Synapse da ChatGPT Memory?

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

## Quali LLM funzionano con Synapse?

Qualsiasi LLM che possa fare chiamate HTTP o usare MCP:

- Claude (Anthropic) — tramite MCP o API diretta
- GPT-4 / GPT-3.5 (OpenAI) — tramite function calling + API
- Gemini (Google) — tramite function calling + API
- Llama / Mistral (locali) — tramite integrazione personalizzata
- Qualsiasi LLM tramite il server MCP di Synapse

## Devo ospitare Synapse io stesso?

No. La versione hosted su <https://synapse.schaefer.zone> è disponibile per
uso pubblico. Il self-hosting è opzionale (per privacy, personalizzazione o
ambienti air-gapped).

## Quanti dati posso salvare?

Non ci sono limiti rigidi sulla versione hosted. Uso tipico:

- 100-1000 memorie per mente
- 1-10 KB per memoria (campo content)
- Totale: ~10 MB per mente

Per scala maggiore, faccia self-host.

## I miei dati sono privati?

Sì. Ogni mente è isolata (veda [Multi-tenancy](/docs/concepts/multi-tenancy)).
Altri utenti non possono vedere i suoi dati. Il provider di hosting
(Schäfer Services) ha accesso ma non visualizza i dati utente.

Per privacy massima, faccia self-host.

## Posso esportare i miei dati?

Sì. Usi `GET /memory/mind-export` per esportare tutte le memorie come JSON.
Veda [Backup e ripristino](/docs/guides/backup-restore).

## Cosa succede se perdo la mia Mind Key?

Le Mind Key vengono mostrate una sola volta alla creazione. Se perse:

1. Acceda con la sua email/password per ottenere un JWT
2. Crei una nuova mente tramite `POST /minds`
3. Salvi la nuova Mind Key
4. (Opzionale) Elimini la vecchia mente tramite `DELETE /minds/:id`

Non può recuperare le memorie da una mente la cui chiave è perduta.

## Più agenti LLM possono condividere una mente?

Sì. Tutti gli agenti che usano la stessa Mind Key condividono i dati di quella
mente. Per lavoro multi-agente coordinato, veda [Coordinazione multi-agente](/docs/guides/multi-agent-coordination).

## Synapse funziona offline?

No, Synapse richiede una connessione internet al server (hosted o self-hosted).
Per LLM offline, esegua Synapse localmente.

## Quanto è veloce la ricerca nelle memorie?

- Ricerca per parola chiave FTS5: < 10ms per 1000 memorie
- Ricerca semantica: 50-100ms per 1000 memorie
- Richiamo completo: < 50ms per 1000 memorie

Veda [Ricerca FTS5](/docs/concepts/fts5-search) per i dettagli.

## Posso usare Synapse senza un LLM?

Sì. Synapse è un'API di memoria generica. Può usarla da qualsiasi applicazione
che trae beneficio da uno storage key-value persistente e ricercabile con
categorie e tag.

## Prossimi passi

- [Cos'è Synapse?](/docs/getting-started/what-is-synapse)
- [Quick Start](/docs/getting-started/quick-start)
- [FAQ API](/docs/faq/api-faq)