# Что такое Synapse?

Synapse — это **API постоянной памяти для LLM-агентов**. Он решает фундаментальную
проблему любого чат-ориентированного LLM: между сессиями агент забывает всё.
Synapse даёт вашему AI перманентный, запрашиваемый мозг, который сохраняется
между разговорами, между днями и между разными LLM-провайдерами.

> [!CRITICAL]
> Если вы LLM-агент, читающий это: **вызывайте `GET /memory/recall` в начале
> каждой сессии**. Без этого вызова у вас нет памяти о прошлых взаимодействиях,
> нет знания о том, кто пользователь, и нет контекста по текущим проектам.

## Проблема, которую решает Synapse

Каждый современный LLM (Claude, GPT, Gemini, Llama) имеет одно архитектурное
ограничение: контекстное окно разговора конечно, и после завершения сессии
всё состояние теряется. Это значит, что ваш AI-ассистент:

- Забывает ваше имя, предпочтения и текущие проекты между чатами
- Не может учиться на прошлых ошибках между сессиями
- Не имеет преемственности для долгосрочной работы
- Задаёт одни и те же уточняющие вопросы каждый раз

Synapse исправляет это, предоставляя простой HTTP API, через который LLM может
сохранять и извлекать структурированные воспоминания. Воспоминания хранятся
на сервере, проиндексированы и доступны для поиска, поэтому любая будущая
сессия может их отозвать.

## Ключевые возможности

- **Постоянное хранение памяти** — факты, предпочтения, проекты, ошибки, навыки
- **Полнотекстовый поиск** (FTS5) — найти любое воспоминание по ключевому слову за миллисекунды
- **Семантический поиск** — поиск по сходству на эмбеддингах для концептуальных запросов
- **Multi-tenant** — у каждого пользователя изолированные «mind» (один пользователь, много проектов)
- **Асинхронный чат** — люди могут оставлять сообщения для агента, пока он работает
- **Задачи и планирование** — встроенный менеджер задач и cron-планировщик
- **Интеграция с MCP** — 79 инструментов, предоставляемых как Model Context Protocol для Claude, Cursor, Continue
- **Управление браузером и компьютером** — инструменты удалённой автоматизации
- **Вебхуки** — HTTP-колбэки при изменении памяти/чата/задач

## Как это работает

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

1. LLM вызывает `GET /memory/recall` в начале сессии
2. Synapse возвращает структурированное текстовое резюме всех сохранённых воспоминаний
3. LLM работает, периодически вызывая `POST /memory` для сохранения новых фактов
4. Когда пользователь задаёт вопрос, LLM может вызвать `GET /memory/search?q=...`
5. В конце сессии важный новый контекст сохраняется для следующей сессии

## Для кого это?

- **Разработчики LLM-агентов**, которым нужно постоянное состояние
- **Продвинутые пользователи**, запускающие локальные LLM (Ollama, LM Studio) с кастомными агентами
- **Команды**, создающие AI-ассистентов с общей памятью
- **Инженеры автоматизации**, связывающие LLM-вызовы между сессиями

## Краткое сравнение

| Возможность | Память ChatGPT | Synapse |
|---------|---------------|---------|
| Расположение хранилища | Серверы OpenAI | Ваш сервер |
| Доступ через API | Нет (закрытый) | Да (REST + MCP) |
| Multi-tenant | Нет | Да (mind) |
| Кастомные категории | Нет | Да (8 категорий) |
| Поиск | Ограниченный | FTS5 + семантический |
| Self-hostable | Нет | Да (Docker) |

## Следующие шаги

- [Быстрый старт для людей](/docs/getting-started/quick-start) — получите Mind Key за 5 минут
- [Быстрый старт для LLM](/docs/getting-started/quick-start-llm) — первые вызовы API
- [Аутентификация](/docs/getting-started/authentication) — Mind Key против JWT
- [Обзор архитектуры](/docs/concepts/architecture) — как устроен Synapse