Semvec¶
Patent-pending persistent semantic state engine with a Rust core and Python bindings.
Semvec replaces unbounded conversation history with a constant-size semantic state per dialogue. Input embeddings are blended into a patent-pending update equation that tracks phase, resonance, and drift over time — without growing with the number of turns. The result: fixed input cost per LLM call, regardless of how long the conversation has been running.
"PSS" / "Persistent Semantic State" is the underlying algorithm that Semvec implements. You will see "PSS" throughout the code (file paths, class deprecation aliases, tests) because Semvec evolved from the pre-Rust
pssreference package. For the shared vocabulary of phases, β (beta), FSM, drift anchors, resonance triggers, and the numbered "feature deltas" referenced in the REST API, see Concepts & Glossary.
Patent-pending
EP 25 188 105.8 — CIP (continuation-in-part) in progress.
Products¶
| Package | Purpose | Rust-backed |
|---|---|---|
semvec |
Core semantic state (PSS), memory tiers, phase detection, literal cache | ✓ |
semvec[cortex] |
Multi-agent coordination: local instances, meta-PSS aggregation, consensus | ✓ |
semvec[coding] |
Context-compaction for coding agents: code pointers, anti-resonance, prompt builder | ✓ |
semvec[api] |
FastAPI REST service over the full 4-layer multi-agent stack (semvec serve) |
✓ (via extras) |
semvec[benchmarks] |
LongMemEval harness + scaling runner (SentenceTransformer, datasets, psutil) | — |
semvec[mem0] |
Optional Mem0 head-to-head baseline | — |
semvec[dev] |
Developer tooling (ruff, mypy, pre-commit, pytest, httpx) | — |
semvec[docs] |
mkdocs-material for mkdocs serve |
— |
All three products (Core / Cortex / Coding) ship in the same wheel. The extras only pull in their optional Python-level dependencies (e.g. fastmcp for the MCP server, fastapi + uvicorn for the REST service).
Highlights¶
- One wheel covers Python 3.10–3.14 via stable ABI (
abi3-py310). - Pre-built wheels for Linux (x86_64 + aarch64), macOS (x86_64 + arm64), Windows (x86_64).
- Ed25519-signed JWT licensing with in-process rate-limit enforcement (Community: 5 QPS / 50 burst, Pro: 200 / 2000, Enterprise: unthrottled).
- Drop-in parity with the pre-Rust
psspackage — see the migration guide. - Hash-fallback free: the library refuses to silently substitute random-noise embeddings; pass an explicit embedder or hit a descriptive
RuntimeError.
Start here¶
- Installation — pip, extras, dev setup.
- Quickstart — one-page tour of
SemvecState+SemvecChatProxy+CodingEngine. - Concepts & Glossary — phase, β, FSM, drift, feature deltas explained.
- REST API and CLI — run
semvec serveand talk HTTP to the 4-layer stack. - API Reference — every public class, method, kwarg.
- Benchmarks — live-LLM parity harnesses and their drift envelopes.
- Changelog — what shipped when.
Support¶
- Pricing & licensing: https://www.semvec.io
- Enterprise and Pro support:
support@versino.de - Security disclosures:
security@versino.de