Practical overview
When it fits
Use Synapse when an agent needs to recall relationships and changes across conversations, and you can provide a self-hosted FalkorDB instance plus an OpenAI-compatible LLM endpoint.
Who it is for
- Developers building AI agents that need persistent memory across conversations.
- Hermes Agent users who want graph-based temporal memory, either in place of or alongside native memory.
- Teams that want to host the memory database themselves and choose an OpenAI-compatible LLM endpoint.
Documented uses
- Retain connected facts and retrieve what was true at an earlier point in time.
- Score memories by importance and let lower-priority information decay.
- Detect novelty or contradictions as new episodes are ingested.
- Expand a search result with its surrounding knowledge-graph context.
Requirements & limits
The repository specifies an MIT license. The documented setup uses Python 3.11 or later and a self-hosted FalkorDB instance.
- Synapse is documented as a Hermes Agent memory provider, so its primary integration path is tied to Hermes.
- The README describes both a brain mode that replaces native memory and a supplementary mode that retains it and mirrors native writes to the graph.
- LLM endpoints must be OpenAI-compatible; the configuration lists an API key and base URL as required variables.
- The README presents performance numbers as projected estimates based on architectural analysis, not measured guarantees.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up Synapse as a Hermes memory provider
Install Synapse, start FalkorDB and configure Hermes to use Synapse for agent memory.
Before you start
- Python 3.11 or later
- Docker for the documented FalkorDB container setup
- A Hermes Agent installation
- An OpenAI-compatible LLM endpoint, API key and base URL
Steps
Start FalkorDB with the documented Docker command, publishing port 6379.
Install Synapse from its Git repository with pip.
Set Hermes's memory provider to synapse.
Configure SYNAPSE_FALKORDB_HOST, SYNAPSE_LLM_API_KEY and SYNAPSE_LLM_BASE_URL in the Hermes environment file.
Expected outcome
Hermes is configured to use Synapse with a FalkorDB host and an LLM endpoint.
Guide limitations
- This recipe covers the README's configuration stage; it does not independently verify a running setup.
- The repository documents Hermes integration rather than a standalone user-facing assistant.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 12 October 2026
- Original website title
- Ardha-Eco-System/synapse · Official homepage title · retained in its source language

