Memory Vault

Local-first AI memory layer with hybrid search. Postgres + pgvector. Self-hosted, MIT.

io.github.MihaiBuilds/memory-vault · Repository · Website · version 1.1.0 · 60 stars · listed from registry

Install

The sweep pulls the image and runs it in a throwaway container, but this is the command a user would run:

docker run -i --rm ghcr.io/mihaibuilds/memory-vault-mcp:1.1.0

Needs credentials: DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.

Results by platform

Linux

needs credentials2026-08-16 · probed over oci

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Traceback (most recent call last):
  File "<frozen runpy>", line 203, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/usr/local/lib/python3.13/site-packages/memory_vault/mcp/__main__.py", line 3, in <module>
    from memory_vault.mcp.server import main
  File "/usr/local/lib/python3.13/site-packages/memory_vault/mcp/server.py", line 41, in <module>
    from memory_vault.models.db import (  # noqa: E402
    ...<5 lines>...
    )
  File "/usr/local/lib/python3.13/site-packages/memory_vault/models/db.py", line 15, in <module>
    from memory_vault.config import settings
  File "/usr/local/lib/python3.13/site-packages/memory_vault/config.py", line 16, in <module>
    class Settings:
    ...<25 lines>...
            )
  File "/usr/local/lib/python3.13/site-packages/memory_vault/config.py", line 19, in Settings
    db_port: int = int(os.getenv("DB_PORT", "5432"))
                   ~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ValueError: invalid literal for int() with base 10: 'DOES_IT_INSTALL_PLACEHOLDER'

macOS

not tested2026-08-16

1 recorded run, oldest first.

docker not available on this runner, so container distributions are probed on Linux only

Windows

never probed

No probe recorded on this platform yet.

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.mihaibuilds__memory-vault.json)](https://doesitinstall.com/s/io.github.mihaibuilds__memory-vault.html)