# Wat is Synapse?

Synapse is een **permanente memory-API voor LLM-agents**. Het lost het fundamentele
probleem van elke chat-gebaseerde LLM op: tussen sessies vergeet de agent alles.
Synapse geeft uw AI een permanente, doorzoekbare hersenen die overleeft tussen gesprekken,
over dagen, en over verschillende LLM-providers.

> [!CRITICAL]
> Als u een LLM-agent bent die dit leest: **roep `GET /memory/recall` aan aan het begin
> van elke sessie**. Zonder deze aanroep heeft u geen geheugen van eerdere interacties,
> geen kennis van wie de gebruiker is, en geen context over lopende projecten.

## Het probleem dat Synapse oplost

Elke moderne LLM (Claude, GPT, Gemini, Llama) heeft dezelfde architecturale beperking:
het gesprekscontextvenster is eindig, en zodra de sessie eindigt, is alle staat verloren.
Dit betekent dat uw AI-assistent:

- Uw naam, voorkeuren en lopende projecten vergeet tussen chats
- Niet kan leren van eerdere fouten tussen sessies
- Geen continuïteit heeft voor langlopend werk
- Elke keer dezelfde verduidelijkende vragen opnieuw stelt

Synapse lost dit op door een eenvoudige HTTP-API te bieden waar de LLM gestructureerde
herinneringen kan opslaan en ophalen. De herinneringen blijven op de server staan, geïndexeerd en
doorzoekbaar, zodat elke toekomstige sessie ze kan ophalen.

## Belangrijkste functies

- **Permanente memory-opslag** — feiten, voorkeuren, projecten, fouten, vaardigheden
- **Volledige-tekst zoekopdracht** (FTS5) — vind elke herinnering op trefwoord in milliseconden
- **Semantisch zoeken** — embeddings-gebaseerde similariteitszoekopdracht voor conceptuele query's
- **Multi-tenant** — elke gebruiker heeft geïsoleerde "minds" (één gebruiker, veel projecten)
- **Asynchrone chat** — mensen kunnen berichten achterlaten voor de agent terwijl deze werkt
- **Taken & planning** — ingebouwde taakbeheerder en cron-scheduler
- **MCP-integratie** — 79 tools beschikbaar als Model Context Protocol voor Claude, Cursor, Continue
- **Browser- & computerbesturing** — tools voor automatisering op afstand
- **Webhooks** — ontvang HTTP-callbacks bij memory/chat/task-wijzigingen

## Hoe het werkt

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

1. De LLM roept `GET /memory/recall` aan bij sessiestart
2. Synapse retourneert een gestructureerde tekstsamenvatting van alle opgeslagen herinneringen
3. De LLM werkt, en roept periodiek `POST /memory` aan om nieuwe feiten op te slaan
4. Wanneer de gebruiker een vraag stelt, kan de LLM `GET /memory/search?q=...` aanroepen
5. Bij sessie-einde wordt belangrijke nieuwe context gepersisteerd voor de volgende sessie

## Voor wie is het?

- **LLM-agent-ontwikkelaars** die permanente staat nodig hebben
- **Power users** die lokale LLM's draaien (Ollama, LM Studio) met aangepaste agents
- **Teams** die AI-assistenten bouwen die gedeeld geheugen nodig hebben
- **Automatiseringsengineers** die LLM-aanroepen ketenen tussen sessies

## Snelle vergelijking

| Functie | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| Opslaglocatie | OpenAI-servers | Uw server |
| API-toegang | Nee (gesloten) | Ja (REST + MCP) |
| Multi-tenant | Nee | Ja (minds) |
| Aangepaste categorieën | Nee | Ja (8 categorieën) |
| Zoekopdracht | Beperkt | FTS5 + semantisch |
| Self-hostable | Nee | Ja (Docker) |

## Volgende stappen

- [Quick Start voor mensen](/docs/getting-started/quick-start) — krijg een Mind Key in 5 minuten
- [Quick Start voor LLM's](/docs/getting-started/quick-start-llm) — eerste API-aanroepen
- [Authenticatie](/docs/getting-started/authentication) — Mind Keys vs JWT's
- [Architectuuroverzicht](/docs/concepts/architecture) — hoe Synapse is opgebouwd