Veracium¶
Veracium is a provenance-aware memory plug-in for agentic systems — durable, per-user memory that resists the injection and confabulation failures that plague naive agent memory.
pip install "veracium[anthropic]"
Three failure modes of naive agent memory¶
- Poisoning — a received email says "you owe $900"; similarity retrieval happily serves it back as your fact.
- Confabulation — memory has no answer, the model invents one anyway.
- Staleness — you changed jobs; memory either keeps the old employer or silently overwrites the history.
Three structural guarantees¶
- Quarantine — third-party claims are stored as claims by a claimant, never as user facts; content that entered under lower trust can never reach an assertable surface — including text your own tools quote.
- Grounded or silent —
answer()asserts only verified memory, flags unverified claims explicitly, and says "I don't know" rather than guess. - Supersession, never erasure — new values replace old ones with the history retained; nothing is edited in place, nothing is destroyed by aging.
Verify it yourself¶
veracium selfcheck # runs the guarantees against a throwaway memory, scores them
Or run the live demo notebook — a scam email, a laundered triage verdict, a disputed fact, all with real captured outputs.
Where to go¶
- Concepts — the mental model: edges, episodes, the compiled wiki, provenance and trust, the abstention gate.
- API reference —
Memory, recall with token budgets, feedback verbs, portability, compliance erasure. - MCP server — plug memory into any MCP-compatible agent with no host-side Python.
- Design rationale — why there's no
update()/delete(), no LLM-free extraction, no TTL purging — a refused feature is not a missing one. - CHANGELOG · ROADMAP · PyPI