synapse
Synapse es una solución auto-alojada para memoria a largo plazo de agentes de IA de codificación (Claude Code/Cursor). Captura transcripciones de sesiones, las estructura en episodios recuperables y construye un grafo de conocimiento. Sirve todo esto vía MCP como resultado único clasificado.
Ficha actualizada 22 sept 2026, 14:51 · upstream 22 sept 2026, 14:25 · release v0.9.1
Qué es synapse
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Synapse resuelve el problema de que las sesiones de Claude Code no tienen memoria entre reinicios. Cada nueva sesión comienza en frío; Synapse indexa lo ocurrido en sesiones pasadas para que una nueva pueda recordar decisiones, construcciones y pruebas realizadas semanas atrás.
La arquitectura utiliza hooks `Stop` para enviar la cola de transcripciones a `/ingest` de forma asíncrona, sin bloquear el flujo del agente. Un poller de fondo agrupa episodios en chunks superpuestos y extrae entidades y hechos bitemporales. La recuperación (`recall`) ejecuta múltiples legs en paralelo: episodio reranked (BM25 + vector), grafo de conocimiento (vector + BM25 + 1-hop), web-research e historia bitemporal.
El stack incluye PostgreSQL para persistencia, soporte Docker Compose y un perfil `local-inference` con LLM local. El benchmark oficial LongMemEval-S reporta 84.8% de precisión, superando a Zep/Graphiti (71.2%) y Mastra (84.2%).
- Recuperar decisiones y contextos de sesiones pasadas en proyectos de código.
- Actualizar conocimiento sobre cambios de proyecto entre versiones temporales.
- Investigación web integrada junto con memoria episódica y grafo de conocimiento.
- Auditoría histórica de lo construido, probado y decidido en sesiones anteriores.
- Arquitectura desacoplada: ingestión asíncrona vía hooks `Stop` sin bloquear el flujo del agente.
- Benchmark validado: 84.8% en LongMemEval-S (superior a Zep/Graphiti/Mastra).
- Soporte multi-leg de recuperación: BM25 + vector, grafo de conocimiento, web-research e historia bitemporal.
- Self-hosted completo con Docker Compose y PostgreSQL; sin dependencia de terceros para datos.
- Calidad de recuperación local inferior al stack Voyage (tuneado en embeddings externos).
- Coste de backfill histórico alto si se usan APIs pagas (Voyage/Anthropic) para ingestión masiva.
- Configuración inicial compleja: requiere token de dispositivo único por máquina y plugin manual.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere 4 núcleos CPU, 8GB RAM, 20GB disco. Usar `docker compose up -d --build`. Ejecutar `synapse-admin bootstrap` con token único por máquina antes del plugin. Configurar `.env` con API keys (Voyage/Anthropic) o usar perfil `local-inference`. Importar historial previo vía `/ingest` si es necesario. Verificar puertos 8765 y 5432 libres.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.