🧠 Personal Memory Gateway (PMG)

The Privacy-First Memory Layer for AI.
Seamlessly bridge your local knowledge with any AI assistant through a secure, MCP-compatible gateway.

🚀 Quick Start

Get up and running in seconds with zero configuration:

npx @shubham-01-star/pmg init

✨ Overview

Personal Memory Gateway (PMG) is a local-first backend designed to store, manage, and serve your personal knowledge to AI models. It acts as a secure "VPN for your memory," ensuring that sensitive data is redacted and privacy is gated before any context is shared.

🛠️ Core Capabilities

• MCP Tool Integration: Seamlessly connects to Cursor, Claude Desktop, and other MCP clients via query_personal_memory and save_memory tools.

• Privacy-First Ingestion: Automatically watches local directories, chunks documents, and stores them in a local vector database (LanceDB).

• Intelligent Redaction: Applies a multi-stage pipeline to redact PII and sensitive information before retrieval.

• Archestra Integration: Optionally route responses through high-performance gateways like Archestra (supporting Gemini/OpenAI).

• Telemetry Dashboard: Monitor system health and manage your indexed data through a built-in web interface.

🏗️ Architecture

graph TD
    A[Local Files] -->|Ingestion| B(Chunking & Embedding)
    B -->|LanceDB| C[Vector Repository]
    D[MCP Client] -->|Query| E[Privacy Pipeline]
    E -->|Redaction| F[Consent Gate]
    F -->|Context| G[AI Model]
    C -->|Retrieval| E

📦 Installation

Global Install (Recommended)

npm i -g @shubham-01-star/pmg
pmg init
pmg

Local Development

git clone https://github.com/shubham-01-star/pmg.git
cd pmg
npm install
npm run build
npm run run

🔌 MCP Client Configuration

Add PMG to your mcpServers configuration:

{
  "mcpServers": {
    "pmg": {
      "command": "npx",
      "args": ["-y", "@shubham-01-star/pmg"],
      "env": {
        "INGEST_DIR": "/path/to/your/data",
        "LANCE_DB_PATH": "/path/to/lancedb/storage"
      }
    }
  }
}

⚙️ Environment Variables

📊 Dashboard

Once running, access the telemetry dashboard at: 👉 http://localhost:8787/dashboard

• Monitor: Real-time events and memory retrieval stats.

• Manage: Upload new documents or clear existing memories.

• Status: Visual health probes for all internal services.

🧪 Testing & Verification

PMG includes a comprehensive suite of smoke tests and backend validations.

# Run backend smoke suite
make test-backend

# Integrated flow test
node scripts/one-command-flow.mjs "topic" "path/to/sample.txt"

📜 License

Distributed under the MIT License. See LICENSE for more information.