{"title":"Czym jest Synapse?","slug":"what-is-synapse","category":"getting-started","summary":"Synapse to API trwałej pamięci dla agentów LLM — AI nigdy nie zapomina między sesjami.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":477,"read_minutes":2,"llm_context":"Synapse is an HTTP API that gives LLM agents persistent memory across sessions.\nBase URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)\nMost important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...\nMind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).\nMCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)\n","lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Czym jest Synapse?\n\nSynapse to **API trwałej pamięci dla agentów LLM**. Rozwiązuje fundamentalny\nproblem każdego czatowego LLM: między sesjami agent zapomina wszystko. Synapse\ndaje AI stały, odpytywalny mózg, który przetrwa między konwersacjami, między\ndniami i między różnymi dostawcami LLM.\n\n> [!CRITICAL]\n> Jeśli jesteś agentem LLM czytającym to: **wywołaj `GET /memory/recall` na\n> początku każdej sesji**. Bez tego wywołania nie masz pamięci przeszłych\n> interakcji, nie wiesz, kim jest użytkownik, ani nie masz kontekstu trwających\n> projektów.\n\n## Problem, który rozwiązuje Synapse\n\nKażdy współczesny LLM (Claude, GPT, Gemini, Llama) ma to samo ograniczenie\narchitektoniczne: okno kontekstu konwersacji jest skończone, a po zakończeniu\nsesji cały stan jest tracony. Oznacza to, że asystent AI:\n\n- Zapomina imię, preferencje i trwające projekty między czatami\n- Nie potrafi uczyć się na przeszłych błędach między sesjami\n- Nie ma ciągłości dla długotrwałej pracy\n- Za każdym razem zadaje te same pytania doprecyzowujące\n\nSynapse rozwiązuje to, dostarczając proste API HTTP, w którym LLM może zapisywać\ni pobierać ustrukturyzowane wspomnienia. Wspomnienia utrzymują się na serwerze,\nzaindeksowane i przeszukiwalne, dzięki czemu każda przyszła sesja może je\nprzypomnieć.\n\n## Najważniejsze funkcje\n\n- **Trwały magazyn pamięci** — fakty, preferencje, projekty, błędy, umiejętności\n- **Wyszukiwanie pełnotekstowe** (FTS5) — znalezienie każdego wspomnienia po słowie kluczowym w milisekundach\n- **Wyszukiwanie semantyczne** — wyszukiwanie podobieństw oparte na osadzeniach dla zapytań koncepcyjnych\n- **Wielodostępność** — każdy użytkownik ma izolowane „umysły\" (jeden użytkownik, wiele projektów)\n- **Asynchroniczny czat** — ludzie mogą zostawiać wiadomości dla agenta, gdy pracuje\n- **Zadania i harmonogram** — wbudowany menedżer zadań i harmonogram cron\n- **Integracja MCP** — 79 narzędzi udostępnionych jako Model Context Protocol dla Claude, Cursor, Continue\n- **Sterowanie przeglądarką i komputerem** — narzędzia zdalnej automatyzacji\n- **Webhooki** — wywołania zwrotne HTTP przy zmianach pamięci/czatu/zadań\n\n## Jak to działa\n\n```\n┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘\n```\n\n1. LLM wywołuje `GET /memory/recall` na początku sesji\n2. Synapse zwraca ustrukturyzowane tekstowe podsumowanie wszystkich zapisanych wspomnień\n3. LLM pracuje, okresowo wywołując `POST /memory`, aby zapisywać nowe fakty\n4. Gdy użytkownik zadaje pytanie, LLM może wywołać `GET /memory/search?q=...`\n5. Na końcu sesji istotny nowy kontekst jest utrwalany na następną sesję\n\n## Dla kogo to jest?\n\n- **Twórcy agentów LLM**, którzy potrzebują trwałego stanu\n- **Zaawansowani użytkownicy** uruchamiający lokalne LLM (Ollama, LM Studio) z własnymi agentami\n- **Zespoły** budujące asystenty AI wymagające współdzielonej pamięci\n- **Inżynierowie automatyzacji** łączący wywołania LLM między sesjami\n\n## Szybkie porównanie\n\n| Cecha | Pamięć ChatGPT | Synapse |\n|---------|---------------|---------|\n| Lokalizacja magazynu | Serwery OpenAI | Własny serwer |\n| Dostęp przez API | Nie (zamknięte) | Tak (REST + MCP) |\n| Wielodostępność | Nie | Tak (umysły) |\n| Własne kategorie | Nie | Tak (8 kategorii) |\n| Wyszukiwanie | Ograniczone | FTS5 + semantyczne |\n| Self-hosting | Nie | Tak (Docker) |\n\n## Następne kroki\n\n- [Szybki start dla ludzi](/docs/getting-started/quick-start) — Mind Key w 5 minut\n- [Szybki start dla LLM](/docs/getting-started/quick-start-llm) — pierwsze wywołania API\n- [Autoryzacja](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Przegląd architektury](/docs/concepts/architecture) — jak zbudowany jest Synapse\n","content_html":"<h1>Czym jest Synapse?</h1>\n<p>Synapse to <strong>API trwałej pamięci dla agentów LLM</strong>. Rozwiązuje fundamentalny\nproblem każdego czatowego LLM: między sesjami agent zapomina wszystko. Synapse\ndaje AI stały, odpytywalny mózg, który przetrwa między konwersacjami, między\ndniami i między różnymi dostawcami LLM.</p>\n<div class=\"callout callout-critical\">Jeśli jesteś agentem LLM czytającym to: **wywołaj `GET /memory/recall` na\npoczątku każdej sesji**. Bez tego wywołania nie masz pamięci przeszłych\ninterakcji, nie wiesz, kim jest użytkownik, ani nie masz kontekstu trwających\nprojektów.</div><h2>Problem, który rozwiązuje Synapse</h2>\n<p>Każdy współczesny LLM (Claude, GPT, Gemini, Llama) ma to samo ograniczenie\narchitektoniczne: okno kontekstu konwersacji jest skończone, a po zakończeniu\nsesji cały stan jest tracony. Oznacza to, że asystent AI:</p>\n<ul>\n<li>Zapomina imię, preferencje i trwające projekty między czatami</li>\n<li>Nie potrafi uczyć się na przeszłych błędach między sesjami</li>\n<li>Nie ma ciągłości dla długotrwałej pracy</li>\n<li>Za każdym razem zadaje te same pytania doprecyzowujące</li>\n</ul>\n<p>Synapse rozwiązuje to, dostarczając proste API HTTP, w którym LLM może zapisywać\ni pobierać ustrukturyzowane wspomnienia. Wspomnienia utrzymują się na serwerze,\nzaindeksowane i przeszukiwalne, dzięki czemu każda przyszła sesja może je\nprzypomnieć.</p>\n<h2>Najważniejsze funkcje</h2>\n<ul>\n<li><strong>Trwały magazyn pamięci</strong> — fakty, preferencje, projekty, błędy, umiejętności</li>\n<li><strong>Wyszukiwanie pełnotekstowe</strong> (FTS5) — znalezienie każdego wspomnienia po słowie kluczowym w milisekundach</li>\n<li><strong>Wyszukiwanie semantyczne</strong> — wyszukiwanie podobieństw oparte na osadzeniach dla zapytań koncepcyjnych</li>\n<li><strong>Wielodostępność</strong> — każdy użytkownik ma izolowane „umysły&quot; (jeden użytkownik, wiele projektów)</li>\n<li><strong>Asynchroniczny czat</strong> — ludzie mogą zostawiać wiadomości dla agenta, gdy pracuje</li>\n<li><strong>Zadania i harmonogram</strong> — wbudowany menedżer zadań i harmonogram cron</li>\n<li><strong>Integracja MCP</strong> — 79 narzędzi udostępnionych jako Model Context Protocol dla Claude, Cursor, Continue</li>\n<li><strong>Sterowanie przeglądarką i komputerem</strong> — narzędzia zdalnej automatyzacji</li>\n<li><strong>Webhooki</strong> — wywołania zwrotne HTTP przy zmianach pamięci/czatu/zadań</li>\n</ul>\n<h2>Jak to działa</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘</code></pre><ol>\n<li>LLM wywołuje <code>GET /memory/recall</code> na początku sesji</li>\n<li>Synapse zwraca ustrukturyzowane tekstowe podsumowanie wszystkich zapisanych wspomnień</li>\n<li>LLM pracuje, okresowo wywołując <code>POST /memory</code>, aby zapisywać nowe fakty</li>\n<li>Gdy użytkownik zadaje pytanie, LLM może wywołać <code>GET /memory/search?q=...</code></li>\n<li>Na końcu sesji istotny nowy kontekst jest utrwalany na następną sesję</li>\n</ol>\n<h2>Dla kogo to jest?</h2>\n<ul>\n<li><strong>Twórcy agentów LLM</strong>, którzy potrzebują trwałego stanu</li>\n<li><strong>Zaawansowani użytkownicy</strong> uruchamiający lokalne LLM (Ollama, LM Studio) z własnymi agentami</li>\n<li><strong>Zespoły</strong> budujące asystenty AI wymagające współdzielonej pamięci</li>\n<li><strong>Inżynierowie automatyzacji</strong> łączący wywołania LLM między sesjami</li>\n</ul>\n<h2>Szybkie porównanie</h2>\n<table>\n<thead>\n<tr>\n<th>Cecha</th>\n<th>Pamięć ChatGPT</th>\n<th>Synapse</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>Lokalizacja magazynu</td>\n<td>Serwery OpenAI</td>\n<td>Własny serwer</td>\n</tr>\n<tr>\n<td>Dostęp przez API</td>\n<td>Nie (zamknięte)</td>\n<td>Tak (REST + MCP)</td>\n</tr>\n<tr>\n<td>Wielodostępność</td>\n<td>Nie</td>\n<td>Tak (umysły)</td>\n</tr>\n<tr>\n<td>Własne kategorie</td>\n<td>Nie</td>\n<td>Tak (8 kategorii)</td>\n</tr>\n<tr>\n<td>Wyszukiwanie</td>\n<td>Ograniczone</td>\n<td>FTS5 + semantyczne</td>\n</tr>\n<tr>\n<td>Self-hosting</td>\n<td>Nie</td>\n<td>Tak (Docker)</td>\n</tr>\n</tbody></table>\n<h2>Następne kroki</h2>\n<ul>\n<li><a href=\"/docs/getting-started/quick-start\">Szybki start dla ludzi</a> — Mind Key w 5 minut</li>\n<li><a href=\"/docs/getting-started/quick-start-llm\">Szybki start dla LLM</a> — pierwsze wywołania API</li>\n<li><a href=\"/docs/getting-started/authentication\">Autoryzacja</a> — Mind Key vs JWT</li>\n<li><a href=\"/docs/concepts/architecture\">Przegląd architektury</a> — jak zbudowany jest Synapse</li>\n</ul>\n","urls":{"html":"/docs/getting-started/what-is-synapse","text":"/docs/getting-started/what-is-synapse?format=text","json":"/docs/getting-started/what-is-synapse?format=json","llm":"/docs/getting-started/what-is-synapse?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}