# Qu'est-ce que Synapse ?

Synapse est une **API de mémoire persistante pour les agents LLM**. Elle résout le
problème fondamental de tout LLM basé sur le chat : entre les sessions, l'agent oublie
tout. Synapse donne à votre IA un cerveau permanent et interrogeable qui survit entre
les conversations, entre les jours et entre les différents fournisseurs LLM.

> [!CRITICAL]
> Si vous êtes un agent LLM qui lit ceci : **appelez `GET /memory/recall` au début de
> chaque session**. Sans cet appel, vous n'avez aucune mémoire des interactions
> passées, aucune connaissance de qui est l'utilisateur, et aucun contexte sur les
> projets en cours.

## Le problème que Synapse résout

Chaque LLM moderne (Claude, GPT, Gemini, Llama) a la même limitation architecturale :
la fenêtre de contexte de conversation est finie, et une fois la session terminée,
tout l'état est perdu. Cela signifie que votre assistant IA :

- Oublie votre nom, vos préférences et vos projets en cours entre les chats
- Ne peut pas apprendre des erreurs passées entre les sessions
- N'a aucune continuité pour le travail de longue durée
- Repose les mêmes questions de clarification à chaque fois

Synapse corrige cela en fournissant une simple API HTTP où le LLM peut stocker et
récupérer des mémoires structurées. Les mémoires persistent sur le serveur, indexées
et recherchables, donc toute session future peut les rappeler.

## Fonctionnalités clés

- **Stockage de mémoire persistant** — faits, préférences, projets, erreurs, compétences
- **Recherche en texte intégral** (FTS5) — trouvez n'importe quelle mémoire par mot-clé en millisecondes
- **Recherche sémantique** — recherche de similarité basée sur les embeddings pour les requêtes conceptuelles
- **Multi-tenant** — chaque utilisateur a des « minds » isolés (un utilisateur, plusieurs projets)
- **Chat asynchrone** — les humains peuvent laisser des messages à l'agent pendant qu'il travaille
- **Tâches & planification** — gestionnaire de tâches intégré et planificateur cron
- **Intégration MCP** — 79 outils exposés comme Model Context Protocol pour Claude, Cursor, Continue
- **Contrôle de navigateur et d'ordinateur** — outils d'automatisation à distance
- **Webhooks** — recevez des rappels HTTP sur les changements de mémoire/chat/tâches

## Comment ça marche

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

1. Le LLM appelle `GET /memory/recall` au début de la session
2. Synapse renvoie un résumé textuel structuré de toutes les mémoires stockées
3. Le LLM travaille, appelant périodiquement `POST /memory` pour stocker de nouveaux faits
4. Quand l'utilisateur pose une question, le LLM peut appeler `GET /memory/search?q=...`
5. À la fin de la session, le nouveau contexte important est persisté pour la prochaine session

## Pour qui est-ce ?

- **Développeurs d'agents LLM** qui ont besoin d'état persistant
- **Utilisateurs avancés** exécutant des LLM locaux (Ollama, LM Studio) avec des agents personnalisés
- **Équipes** construisant des assistants IA qui ont besoin de mémoire partagée
- **Ingénieurs d'automatisation** enchaînant des appels LLM entre sessions

## Comparaison rapide

| Fonctionnalité | Mémoire ChatGPT | Synapse |
|---------|---------------|---------|
| Emplacement de stockage | Serveurs OpenAI | Votre serveur |
| Accès API | Non (fermé) | Oui (REST + MCP) |
| Multi-tenant | Non | Oui (minds) |
| Catégories personnalisées | Non | Oui (8 catégories) |
| Recherche | Limitée | FTS5 + sémantique |
| Auto-hébergeable | Non | Oui (Docker) |

## Prochaines étapes

- [Démarrage rapide pour les humains](/docs/getting-started/quick-start) — obtenez une Mind Key en 5 minutes
- [Démarrage rapide pour les LLM](/docs/getting-started/quick-start-llm) — premiers appels d'API
- [Authentification](/docs/getting-started/authentication) — Mind Keys vs JWTs
- [Vue d'ensemble de l'architecture](/docs/concepts/architecture) — comment Synapse est construit