Metadata-Version: 2.4
Name: phorvec
Version: 0.1.2
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
License-File: LICENSE
Summary: Persistent vector memory and RAG for AI agents — MCP server with 150+ tools
Keywords: mcp,vector-database,ai-agents,rag,embeddings,memory
Author: Phorvec Contributors
License: BSL-1.1
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/Teressoft/phorvec
Project-URL: Issues, https://github.com/Teressoft/phorvec/issues
Project-URL: Repository, https://github.com/Teressoft/phorvec

# 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

```bash
pip install phorvec
```

### Configure with Claude Code

Add to your Claude Code MCP settings:

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

### Configure with Cursor / Windsurf

Add to your MCP configuration:

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

## Use phorvec in your code (Python)

```bash
pip install phorvec
```

```python
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`](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>.

