anshulyadav1976/synapse

Point it at text. Get a searchable archive for free. Spend a few cents turning it into a Markdown wiki your agent can query.
Give any AI agent or workspace application a private, local memory without filling every prompt with your history:
bash
uvx --from synapse-vault synapse mcp --vault /absolute/path/to/my-brain
That command is a local STDIO MCP server, not a Codex or OpenAI integration. Connect it directly to MCP-capable clients such as Codex, Claude Code, OpenCode, or OpenClaw. Pi, Orbit, Hermes, and other workspace agents can use MCP when supported or the bundled skill and CLI. See the copy-paste setup examples.
Nothing from the vault is injected into the agent's prompt. The agent searches first, then reads one relevant Markdown page. A thousand unopened pages cost zero tokens.
## See it in ten seconds
bash
uvx --from synapse-vault synapse serve --demo
That opens a populated 20-page graph. It needs no API key, import, database server, or JavaScript build.
## Keep your own history
bash
uvx --from synapse-vault synapse init ./my-brain
uvx --from synapse-vault synapse ingest ~/Downloads/chatgpt-export --vault ./my-brain
uvx --from synapse-vault synapse serve --vault ./my-brain
A claude.ai export zip works the same way; the format is detected automatically.
Ingest is local and free: it writes Markdown and builds a disposable SQLite FTS5 index. Search works immediately:
bash
uvx --from synapse-vault synapse search "the phrase I remember" --vault ./my-brain
If keyword wording starts missing obvious matches, add the optional semantic cache and fuse both rankings:
bash
export SYNAPSEAPIKEY="..."
uvx --from synapse-vault synapse embed --vault ./my-brain --dry-run
uvx --from synapse-vault synapse embed --vault ./my-brain
uvx --from synapse-vault synapse search "the idea about handling growth" --hybrid --vault ./my-brain
This adds no dependency or vector server. Embeddings are derived from wiki pages and approved notes, stored in the same disposable SQLite file, and never replace FTS5. Raw-history embeddings require the explicit --include-raw flag.
To turn raw history into a linked wiki, estimate first and then build a small resumable batch:
bash
export SYNAPSEAPIKEY="..."
uvx --from synapse-vault synapse build --vault ./my-brain --limit 20 --dry-run
uvx --from synapse-vault synapse build --vault ./my-brain --limit 20
The build pass is optional. It is a plain for loop making one OpenAI-compatible chat-completions request per item. Run it against OpenAI or a local Ollama/LM Studio server; stop and resume without paying twice.
## Markdown is the database
text
my-brain/
├── raw/ / / .md immutable imported history
├── wiki/ .md linked, editable knowledge pages
├── notes/ .md approved, append-only agent notes
├── synapse.db disposable search + graph indexes
└── synapse.toml model and owner settings
Delete synapse.db and synapse reindex --vault ./my-brain recreates FTS and the graph; run synapse embed again only if you use optional semantic search. The durable data is ordinary Markdown that works with git, Obsidian, grep, and any editor.
## How it works
1. An adapter streams each source into a tiny Item shape with stable IDs and timestamps.