# Czym jest Synapse?

Synapse to **API trwałej pamięci dla agentów LLM**. Rozwiązuje fundamentalny
problem każdego czatowego LLM: między sesjami agent zapomina wszystko. Synapse
daje AI stały, odpytywalny mózg, który przetrwa między konwersacjami, między
dniami i między różnymi dostawcami LLM.

> [!CRITICAL]
> Jeśli jesteś agentem LLM czytającym to: **wywołaj `GET /memory/recall` na
> początku każdej sesji**. Bez tego wywołania nie masz pamięci przeszłych
> interakcji, nie wiesz, kim jest użytkownik, ani nie masz kontekstu trwających
> projektów.

## Problem, który rozwiązuje Synapse

Każdy współczesny LLM (Claude, GPT, Gemini, Llama) ma to samo ograniczenie
architektoniczne: okno kontekstu konwersacji jest skończone, a po zakończeniu
sesji cały stan jest tracony. Oznacza to, że asystent AI:

- Zapomina imię, preferencje i trwające projekty między czatami
- Nie potrafi uczyć się na przeszłych błędach między sesjami
- Nie ma ciągłości dla długotrwałej pracy
- Za każdym razem zadaje te same pytania doprecyzowujące

Synapse rozwiązuje to, dostarczając proste API HTTP, w którym LLM może zapisywać
i pobierać ustrukturyzowane wspomnienia. Wspomnienia utrzymują się na serwerze,
zaindeksowane i przeszukiwalne, dzięki czemu każda przyszła sesja może je
przypomnieć.

## Najważniejsze funkcje

- **Trwały magazyn pamięci** — fakty, preferencje, projekty, błędy, umiejętności
- **Wyszukiwanie pełnotekstowe** (FTS5) — znalezienie każdego wspomnienia po słowie kluczowym w milisekundach
- **Wyszukiwanie semantyczne** — wyszukiwanie podobieństw oparte na osadzeniach dla zapytań koncepcyjnych
- **Wielodostępność** — każdy użytkownik ma izolowane „umysły" (jeden użytkownik, wiele projektów)
- **Asynchroniczny czat** — ludzie mogą zostawiać wiadomości dla agenta, gdy pracuje
- **Zadania i harmonogram** — wbudowany menedżer zadań i harmonogram cron
- **Integracja MCP** — 79 narzędzi udostępnionych jako Model Context Protocol dla Claude, Cursor, Continue
- **Sterowanie przeglądarką i komputerem** — narzędzia zdalnej automatyzacji
- **Webhooki** — wywołania zwrotne HTTP przy zmianach pamięci/czatu/zadań

## Jak to działa

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

1. LLM wywołuje `GET /memory/recall` na początku sesji
2. Synapse zwraca ustrukturyzowane tekstowe podsumowanie wszystkich zapisanych wspomnień
3. LLM pracuje, okresowo wywołując `POST /memory`, aby zapisywać nowe fakty
4. Gdy użytkownik zadaje pytanie, LLM może wywołać `GET /memory/search?q=...`
5. Na końcu sesji istotny nowy kontekst jest utrwalany na następną sesję

## Dla kogo to jest?

- **Twórcy agentów LLM**, którzy potrzebują trwałego stanu
- **Zaawansowani użytkownicy** uruchamiający lokalne LLM (Ollama, LM Studio) z własnymi agentami
- **Zespoły** budujące asystenty AI wymagające współdzielonej pamięci
- **Inżynierowie automatyzacji** łączący wywołania LLM między sesjami

## Szybkie porównanie

| Cecha | Pamięć ChatGPT | Synapse |
|---------|---------------|---------|
| Lokalizacja magazynu | Serwery OpenAI | Własny serwer |
| Dostęp przez API | Nie (zamknięte) | Tak (REST + MCP) |
| Wielodostępność | Nie | Tak (umysły) |
| Własne kategorie | Nie | Tak (8 kategorii) |
| Wyszukiwanie | Ograniczone | FTS5 + semantyczne |
| Self-hosting | Nie | Tak (Docker) |

## Następne kroki

- [Szybki start dla ludzi](/docs/getting-started/quick-start) — Mind Key w 5 minut
- [Szybki start dla LLM](/docs/getting-started/quick-start-llm) — pierwsze wywołania API
- [Autoryzacja](/docs/getting-started/authentication) — Mind Key vs JWT
- [Przegląd architektury](/docs/concepts/architecture) — jak zbudowany jest Synapse