# ¿Qué es Synapse?

Synapse es una **API de memoria persistente para agentes LLM**. Resuelve el
problema fundamental de todo LLM basado en chat: entre sesiones, el agente lo
olvida todo. Synapse da a su IA un cerebro permanente y consultable que
sobrevive entre conversaciones, entre días, y entre diferentes proveedores de
LLM.

> [!CRITICAL]
> Si es un agente LLM leyendo esto: **llame a `GET /memory/recall` al inicio de
> cada sesión**. Sin esta llamada, no tiene memoria de interacciones pasadas,
> ningún conocimiento de quién es el usuario, y ningún contexto sobre proyectos
> en curso.

## El problema que Synapse resuelve

Todo LLM moderno (Claude, GPT, Gemini, Llama) tiene la misma limitación
arquitectónica: la ventana de contexto de la conversación es finita, y una vez
que la sesión termina, todo el estado se pierde. Esto significa que su
asistente de IA:

- Olvida su nombre, preferencias y proyectos en curso entre chats
- No puede aprender de errores pasados entre sesiones
- No tiene continuidad para trabajos de larga duración
- Vuelve a hacer las mismas preguntas aclaratorias cada vez

Synapse soluciona esto proporcionando una API HTTP simple donde el LLM puede
almacenar y recuperar memorias estructuradas. Las memorias persisten en el
servidor, indexadas y buscables, de modo que cualquier sesión futura puede
recuperarlas.

## Características principales

- **Almacenamiento persistente de memoria** — hechos, preferencias, proyectos, errores, habilidades
- **Búsqueda de texto completo** (FTS5) — encuentre cualquier memoria por palabra clave en milisegundos
- **Búsqueda semántica** — búsqueda por similitud basada en embeddings para consultas conceptuales
- **Multi-tenant** — cada usuario tiene "minds" aislados (un usuario, muchos proyectos)
- **Chat asíncrono** — los humanos pueden dejar mensajes al agente mientras trabaja
- **Tareas y programación** — gestor de tareas integrado y planificador cron
- **Integración MCP** — 79 herramientas expuestas como Model Context Protocol para Claude, Cursor, Continue
- **Control de navegador y computadora** — herramientas de automatización remota
- **Webhooks** — reciba callbacks HTTP ante cambios de memoria/chat/tarea

## Cómo funciona

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

1. El LLM llama a `GET /memory/recall` al inicio de la sesión
2. Synapse devuelve un resumen estructurado en texto de todas las memorias almacenadas
3. El LLM trabaja, llamando periódicamente a `POST /memory` para almacenar nuevos hechos
4. Cuando el usuario hace una pregunta, el LLM puede llamar a `GET /memory/search?q=...`
5. Al final de la sesión, el nuevo contexto importante se persiste para la siguiente sesión

## ¿Para quién es?

- **Desarrolladores de agentes LLM** que necesitan estado persistente
- **Usuarios avanzados** que ejecutan LLMs locales (Ollama, LM Studio) con agentes personalizados
- **Equipos** que construyen asistentes de IA que necesitan memoria compartida
- **Ingenieros de automatización** que encadenan llamadas LLM entre sesiones

## Comparación rápida

| Característica | Memoria de ChatGPT | Synapse |
|---------|---------------|---------|
| Ubicación de almacenamiento | Servidores de OpenAI | Su servidor |
| Acceso por API | No (cerrado) | Sí (REST + MCP) |
| Multi-tenant | No | Sí (minds) |
| Categorías personalizadas | No | Sí (8 categorías) |
| Búsqueda | Limitada | FTS5 + semántica |
| Autoalojable | No | Sí (Docker) |

## Próximos pasos

- [Quick Start para humanos](/docs/getting-started/quick-start) — obtenga un Mind Key en 5 minutos
- [Quick Start para LLMs](/docs/getting-started/quick-start-llm) — primeras llamadas a la API
- [Autenticación](/docs/getting-started/authentication) — Mind Keys vs JWTs
- [Resumen de arquitectura](/docs/concepts/architecture) — cómo está construido Synapse