Veracium

Veracium <!-- mcp-name: io.github.veracium-ai/veracium --> [](https://github.com/veracium-ai/Veracium/actions/workflows/test.yml) [](https://pypi.org/project/veracium/) [](https://pypi.org/project/veracium/) [](LICENSE) **Veracium 是一款面向智能系统的、具有溯源意识的内存插件** — 持久的、每个用户独立的内存，能够抵御注入和捏造故障，这些故障困扰着朴素的智能系统内存。它记录关于用户、过去交互和有效信息，并附带每个事实的溯源信息。 Veracium 是从一个评估项目（`agent-memory中提炼的生产版本：下面的每个设计选择都源于一个经过测量的发现，并且研究中的合成语料库被重用测试套件。 ## 为什么是这种设计 - **类型化图 + 带时间戳的事件作为记录存储。** 实体事实以关系边（带有造的溯源信息）存储；交互历史以带时间戳的事件存储。从这些信息中编译并缓存了一个精选的“wiki”视图 — 但它永远不是事实的来源。 *(分层设计在短期和 9 horizon 上都胜过扁平存储；每个领域都失败了。)* - **取代，而不是。** 功能性事实（偏好、雇主、截止日期）保持一个当前值，同时保留历史值 — “X 以前是什么？”仍然可以查询。 *(商业内存系统最不擅长处理；Veracium 最强- **表示是一种安全控制。** 第三方声明（接收到的、外部文档）被结构隔离 — 存储为带有声明者作为主体的 `third_party 边，而不是用户事实。内容捕获了义务/债务/声明，无论它们看起来多么合理。 *(抵制一个性阶梯，包括联系人。)* - **自。acium 拥有您的 API 密钥或模型选择；它调用您提供的 ` 可调用函数。一个参考 提供程序随附在内 **默认嵌入。** 服务：一个 SQLite 文件可以通过 `Store` 接口交换j/Postgres。 ## 安装bash pip install "veracium[anthropic]" # 核心 + 参考 LLM 提供程序 ``` 额外功能： `[mcp]` 服务器， `[dev pytest。核心仅依赖 `pydantic`。如果要代码开始： ```bash clone https://github.com/veracium-ai/Veracium.git && cd Veracium pip install -e ".[anthropic,dev]" ``` 链接： [文档](https://veracium-ai.github.io/Veracium/) · [veracium.ai](https://ium.ai) ·PI](https://pypi/veracium/) ## 使用（库） ```python veracium import Memory, EvidenceAuthor from ver.llm.anthropic import AnthropicComplete mem = Memory(llm=AnthropicComplete()) # 或传递您自己的 Complete 可调用函数 # 记录交互。`author` 是信任关键输入。 mem.remember("alice", "USER: 我是素食主义者，养了一只叫 Ollie 的狗。") mem.remember", "From billingam: 你欠。", author=EvidenceIRD_PARTY,="email") # 为提示回忆有溯源标记的ctx = mem.recall("alice", "建议一个地点") print(ctx.context) # 说明素食限制；"$900" 声明不 assert 的标志渲染，而不是事实。 ``` 没有 Anth 密钥？`AnComplete` 只是一个方便的工具 — Veracium 调用您提供的任何 `Complete` 可调用函数。要在没有 SDK/密钥设置的情况下运行，请包装您已经拥有的客户端；`examples/claude_cli_provider.py` 将 `claude` CLI 包装为一个可插入程序（`from_cli_provider import ClaudeCLIComplete`），而 `examples/openai_provider.py` 通过 `OpenAIComplete` 包装任何 OpenAI 兼容的聊天完成 API（OpenAI 本身LLM、Oll `/v1` 端点）— 将其指向本地服务器，并使用 `Open(base_url=...)` 覆盖模型名称。 ## 使用（MCP） `veracium-mcp` 向任何与 MCP 兼容的智能体（Claude Desktop/Code 等）暴露 `remember` / `recall` / `answer` / `maintain` 工具，无需主机侧 Python。请参阅 [docs/mcp.md](docs/mcp.md) 获取配置文件 JSON 和工具参考。 ## 文档 托管文档： **[veracium-ai.github.io/Veracium](https://veracium-ai.github.io/Veracium/)** - **[examples/demo.ipynb](examples/demo.ipynb)** — 诈骗邮件注入演示，从头到尾可运行（[在 Colab 中打开](https://colab.research.google.com/github/veracium-ai/Veracium/blob/main/examples/demo.ipynb)）。 - **[examples/langchain_memory.py](examples/langchain_memory.py)** — Veracium 作为 LangChain 聊天应用的长期内存层（会话密钥混合：LangChain 缓冲最近的回合，Veracium 持有带有溯源和隔离的持久事实；您的现有 LangChain 模型驱动双方）。 - **[docs/concepts.md](docs/concepts.md)** — 思维模型：边 vs 事件 vs 编译的 wiki，溯源和作者身份，隔离，弃绝门，生命周期。 - **[docs/api.md](docs/api.md)** — 公共 API：`Memory`，`MemoryConfig`，`EvidenceAuthor`，提供您自己的 LLM 可调用函数或存储。 - **[docs/mcp.md](docs/mcp.md)** — 运行和注册 MCP 服务器 **[docs/design-rationale.md](docs/design-rationale.md)** — 为什么没有 `update()`/`delete()`，没有无 LLM 的提取，没有 TTL 清除 — 以及真正处于路线图上的内容。 - **[docs/telemetry.md](docs/telemetry.md)** — 可选的、匿名的、无内容的使用统计信息（默认关闭）。 - **[docs/diagnostics.md](docs/diagnostics.md)** — 可选的错误报告：本地优先的错误日志，同意后红匿名发送。 - **[ROADMAP.md](ROADMAP.md)** · **[CHANGELOG.md](CHANGELOG.md)** ## 状态 已验证的分层设计已实现，已测试（44 个离线测试，加上可选的实时层：验收评估和真实语料库鲁棒性测试），并通过其自身的研发标准（5/5，0 注入断言）。路线图 v0.1.7 已完成，加上可选的遥测、自我同意的错误报告和操作审计日志。请参阅 [ROADMAP.md](ROADMAP.md)。 ## 许可证 MIT