phorvec 0.1.2

Persistent vector memory and RAG for AI agents — MCP server with 150+ tools

Phorvec

Persistent vector memory for AI agents. One file per agent, MCP-native, local-first.

What is Phorvec?

Phorvec is an embedded vector database designed for multi-agent AI systems. Each AI agent gets its own isolated .avdb database file with vector search, key-value storage, and a knowledge graph — all accessible through the Model Context Protocol (MCP).

Key Features

• One-file-per-agent architecture (.avdb files) — portable, isolated, no shared state
• MCP-native — works with Claude Code, Cursor, Windsurf, Cline, and any MCP client
• 150+ tools — context persistence, semantic search, team memory, conflict detection, skill library
• Local-first — all data stays on your machine, zero cloud dependency
• Hybrid search — vector similarity + BM25 keyword search with RRF fusion
• Knowledge graph — entity and relationship tracking across sessions
• Compression — PCA spine+delta encoding for storage efficiency

Quick Start

Install

pip install phorvec

Configure with Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "phorvec": {
      "command": "phorvec",
      "args": []
    }
  }
}

Configure with Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "phorvec": {
      "command": "phorvec",
      "args": [],
      "transport": "stdio"
    }
  }
}

Use phorvec in your code (Python)

pip install phorvec

from phorvec import Memory
with Memory.open("./agent-memory", agent_id="assistant-1") as mem:
    mem.store("The user prefers metric units")
    for h in mem.recall("what units?", top_k=5):
        print(h.score, h.content)

pip install phorvec is the free (Community) library + the phorvec MCP CLI. Team/enterprise features (the phorvec.Team API) ship in the paid wheel from your account dashboard.

Architecture

Nexus (nexus.json)       — Central registry mapping agent IDs to file paths
    |
HandleManager            — LRU cache of open agent databases (default cap: 500)
    |
AgentDB (.avdb)          — Per-agent database with vector storage + KV store + graph

Configuration

Phorvec uses a TOML config file at ~/.phorvec/config.toml. The server runs with sensible defaults — no config file required.

Environment Variables

Variable	Description
PHORVEC_LOG_LEVEL	Log level (default: info)
PHORVEC_DATA_DIR	Data directory (default: ~/.phorvec/data)
PHORVEC_STORAGE_BACKEND	Storage backend: lancedb or lite

License

Proprietary. Copyright (c) 2026 Teressoft. All rights reserved.

The source code in this repository is closed and not licensed for redistribution. See LICENSE for the terms.

Use of the distributed phorvec binary (free Community tier or any paid tier) is governed by the End User License Agreement at https://phorvec.com/terms.