Docs/Python Library

Python Library

phorvec ships as a Python package with a compiled core — one self-contained wheel, no external services. pip install phorvec gives you the full free-tier feature surface; paid tiers add more tools through the same pip install, pointed at your licensed index.

Install (free tier)

pip install phorvec

That's it — the wheel bundles everything (zero Python dependencies). On first use phorvec downloads the embedding model (~90 MB, all-MiniLM-L6-v2) into ~/.phorvec/models, then runs fully offline.

import phorvec

# Memory owns its engine — use it as a context manager.
with phorvec.Memory.open("~/.phorvec/data", agent_id="my-agent") as mem:
    mem.store("Prefer ripgrep over grep for code search.", category="learning")
    for hit in mem.recall("how should I search code?"):
        print(hit.score, hit.content)

Every feature family has an ergonomic wrapper (Graph, Context, Rag, Skills, Facts, MemoryBlocks, Snapshots, Branches, Agents, Chat, and more). See the cookbook for a section per family.

Upgrade to a paid tier

Paid tiers (MCP Pro / Max / Team / Enterprise) ship as a separate wheel that adds the paid tools — including the team_* multi-agent suite. You install it with the same pip install, pointed at your licensed index. Your license key lives in your account — sign in to copy it from phorvec.com/account.

Already have pip install phorvec? Run phorvec upgrade

phorvec upgrade <YOUR-KEY>

This swaps your existing free-wheel install for the paid wheel from the licensed index and unlocks the paid tools for your tier. Restart your MCP server / Python process afterward — an already-running process keeps using the wheel it loaded at startup.

Brand new? Install directly

pip install --index-url https://__token__:<YOUR-KEY>@www.phorvec.com/pip/ phorvec

pip authenticates with the license embedded in the index URL, and the index serves the paid wheel for your platform and tier.

Advanced: ~/.netrc

If you'd rather not put the key in a command, add it to ~/.netrc (create it if needed, then chmod 600 ~/.netrc):

machine www.phorvec.com
login __token__
password PHORVEC-LICENSE-V2.your-license-key-here

Then install (or upgrade) from the licensed index without a key in the URL:

pip install --index-url https://www.phorvec.com/pip/ phorvec

Notes

  • The paid wheel is byte-identical across paid tiers; your license decides which tools are unlocked at runtime. A Community license (or none) runs the free-tier feature set.
  • To pin a version: phorvec upgrade <YOUR-KEY> always takes the current release; to pin, use the direct index form with a version pin — pip install --index-url https://www.phorvec.com/pip/ phorvec==0.1.2 (with ~/.netrc credentials configured).
  • CI: set ~/.netrc (or a PIP_INDEX_URL with an encoded key) in the job environment. The index request is rate-limited per license.
  • If pip reports it can't find phorvec at the index, check that your license hasn't expired and that the credentials reached the server (a 401/403 from https://www.phorvec.com/pip/phorvec/ indicates an auth/tier problem).
PreviousGetting StartedNextMCP Client Setup