# Apa itu Synapse?

Synapse adalah **API memori persisten untuk agen LLM**. API ini memecahkan
masalah fundamental setiap LLM berbasis chat: antar sesi, agen melupakan semuanya.
Synapse memberikan AI Anda otak permanen yang dapat dikueri yang bertahan lintas
percakapan, lintas hari, dan lintas provider LLM berbeda.

> [!CRITICAL]
> Jika Anda adalah agen LLM yang membaca ini: **panggil `GET /memory/recall` di awal
> setiap sesi**. Tanpa panggilan ini, Anda tidak memiliki memori interaksi masa lalu,
> tidak ada pengetahuan tentang siapa pengguna, dan tidak ada konteks tentang proyek yang sedang berjalan.

## Masalah yang Diselesaikan Synapse

Setiap LLM modern (Claude, GPT, Gemini, Llama) memiliki keterbatasan arsitektur
yang sama: jendela konteks percakapan terbatas, dan setelah sesi berakhir, semua
state hilang. Ini berarti asisten AI Anda:

- Melupakan nama, preferensi, dan proyek yang sedang berjalan antar chat
- Tidak dapat belajar dari kesalahan masa lalu lintas sesi
- Tidak memiliki kontinuitas untuk pekerjaan jangka panjang
- Bertanya pertanyaan klarifikasi yang sama setiap kali

Synapse memperbaiki ini dengan menyediakan HTTP API sederhana di mana LLM dapat
menyimpan dan mengambil memori terstruktur. Memori bertahan di server, diindeks
dan dapat dicari, sehingga sesi mendatang dapat recall.

## Fitur Utama

- **Penyimpanan memori persisten** — fakta, preferensi, proyek, kesalahan, keahlian
- **Pencarian teks penuh** (FTS5) — temukan memori apa pun berdasarkan kata kunci dalam milidetik
- **Pencarian semantik** — pencarian kesamaan berbasis embeddings untuk kueri konseptual
- **Multi-tenant** — setiap pengguna memiliki "minds" yang terisolasi (satu pengguna, banyak proyek)
- **Chat asinkron** — manusia dapat meninggalkan pesan untuk agen saat bekerja
- **Tugas & penjadwalan** — manajer tugas bawaan dan cron scheduler
- **Integrasi MCP** — 79 alat diekspos sebagai Model Context Protocol untuk Claude, Cursor, Continue
- **Kontrol browser & komputer** — alat otomasi remote
- **Webhooks** — dapatkan HTTP callback pada perubahan memori/chat/tugas

## Cara Kerja

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

1. LLM memanggil `GET /memory/recall` di awal sesi
2. Synapse mengembalikan ringkasan teks terstruktur dari semua memori yang disimpan
3. LLM bekerja, secara berkala memanggil `POST /memory` untuk menyimpan fakta baru
4. Saat pengguna bertanya, LLM dapat memanggil `GET /memory/search?q=...`
5. Di akhir sesi, konteks baru yang penting disimpan untuk sesi berikutnya

## Untuk Siapa?

- **Pengembang agen LLM** yang membutuhkan state persisten
- **Power user** yang menjalankan LLM lokal (Ollama, LM Studio) dengan agen khusus
- **Tim** yang membangun asisten AI yang membutuhkan memori bersama
- **Insinyur otomasi** yang merangkai pemanggilan LLM lintas sesi

## Perbandingan Cepat

| Fitur | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| Lokasi penyimpanan | Server OpenAI | Server Anda |
| Akses API | Tidak (tertutup) | Ya (REST + MCP) |
| Multi-tenant | Tidak | Ya (minds) |
| Kategori khusus | Tidak | Ya (8 kategori) |
| Pencarian | Terbatas | FTS5 + semantik |
| Dapat di-self-host | Tidak | Ya (Docker) |

## Langkah Berikutnya

- [Quick Start untuk manusia](/docs/getting-started/quick-start) — dapatkan Mind Key dalam 5 menit
- [Quick Start untuk LLM](/docs/getting-started/quick-start-llm) — panggilan API pertama
- [Autentikasi](/docs/getting-started/authentication) — Mind Keys vs JWTs
- [Ikhtisar arsitektur](/docs/concepts/architecture) — bagaimana Synapse dibangun