https://github.com/edlontech/mnemosyne_zvex
A Mnemosyne Adapter backed by ZVEC
https://github.com/edlontech/mnemosyne_zvex
agents ai vector-search zvec
Last synced: 2 days ago
JSON representation
A Mnemosyne Adapter backed by ZVEC
- Host: GitHub
- URL: https://github.com/edlontech/mnemosyne_zvex
- Owner: edlontech
- License: mit
- Created: 2026-05-13T13:26:19.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-19T11:24:59.000Z (about 1 month ago)
- Last Synced: 2026-05-19T13:09:45.070Z (about 1 month ago)
- Topics: agents, ai, vector-search, zvec
- Language: Elixir
- Homepage:
- Size: 47.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# MnemosyneZvex
A [Mnemosyne](https://github.com/edlontech/mnemosyne) `GraphBackend` backed by
[Zvex](https://github.com/edlontech/zvex), an in-process vector database, plus
a DETS sidecar for typed links and mutable per-node metadata.
## Installation
```elixir
def deps do
[
{:mnemosyne_zvex, "~> 0.1.0"} # x-release-please-version
]
end
```
## Usage
```elixir
# Configure Mnemosyne's shared adapters once in your supervisor
children = [
{Mnemosyne.Supervisor,
config: %Mnemosyne.Config{
llm: %{model: "gpt-4o", opts: %{}},
embedding: %{model: "text-embedding-3-small", opts: %{}}
},
llm: MyApp.LLMAdapter,
embedding: MyApp.EmbeddingAdapter}
]
# Then open a repo backed by MnemosyneZvex
{:ok, _pid} =
Mnemosyne.open_repo("my-project",
backend: {MnemosyneZvex.Backend,
path: "/var/data/mnemosyne/my-project",
dimension: 1536}
)
# Use Mnemosyne normally
{:ok, session} = Mnemosyne.start_session("Help user plan a trip", repo: "my-project")
:ok = Mnemosyne.append(session, "User says they want to visit Tokyo", "Asking dates")
:ok = Mnemosyne.close_and_commit(session)
{:ok, memories} = Mnemosyne.recall("my-project", "What does the user want?")
```
## Options
| Option | Required | Default | Description |
|---|---|---|---|
| `:path` | yes | — | Directory under which `zvex/` and `sidecar.dets` will live |
| `:dimension` | yes | — | Embedding dimension (must match your `embedding` adapter) |
| `:index` | no | `:hnsw` | Vector index type: `:hnsw`, `:ivf`, or `:flat` |
| `:metric` | no | `:cosine` | Distance metric: `:cosine`, `:l2`, or `:ip` |
| `:index_opts` | no | `[m: 16, ef_construction: 200]` | Index-specific parameters |
| `:fetch_multiplier` | no | `3` | Over-fetch factor for value function reranking |