Repolode
tinyhumansai

tinyhumansai/tinycortex

一个用 Rust 编写的本地优先 AI 记忆库,在写入时过滤低价值内容,并以 Markdown 为源提供可配置的检索。

Star
269
Fork
41
未关闭 Issue
30
最近提交
5天前

这是什么?

TinyCortex 是一个开源的 Rust 库,为 AI 代理和应用提供记忆层。它不会把所有内容都存下来再按相似度召回,而是在写入时通过多信号准入门过滤低价值内容,让检索到的上下文更聚焦。

Markdown 文件是内容的唯一来源。SQLite 分块记录、摘要树、向量索引以及基于 git 的变更记录(需启用 git-diff 特性)都是可从原始内容重建的派生索引。每条记录都保留来源信息,并带有内部或外部同步的安全 taint 标记。

检索部分提供关键词、向量、图关系、摘要树和新鲜度评分等基础能力,并附带可配置权重的混合评分组合器。该库已发布到 crates.io,同时提供内存版参考存储,便于快速试用。

核心功能

  • 01写入时通过准入门过滤低价值内容。
  • 02Markdown 文件作为权威存储,其他索引可随时重建。
  • 03提供关键词、向量、图和摘要树等检索基础能力。
  • 04默认 7 天半衰期的指数新鲜度衰减。
  • 05通过 git-diff 特性可选启用基于 git 的变更追踪。
  • 06每条记录保留来源信息和安全 taint 标记。

适用场景

  • 为用 Rust 编写的自定义 AI 代理添加长期记忆。
  • 构建可直接以 Markdown 查看的本地优先知识库。
  • 试验结合时效性与语义相关性的排序策略。

快速上手

  1. 1

    将 crate 及异步依赖添加到你的 Rust 项目

    cargo add tinycortex anyhow
  2. 2

    添加示例中所需运行时特性的 tokio

    cargo add tokio --features macros,rt-multi-thread
  3. 3

    在代码中使用内存后端存储并检索一条记忆

使用前须知

  • 它只是一个 Rust 库,没有独立的应用程序。
  • 托管版 TinyCortex 平台处于封闭内测阶段,不包含在本仓库中。
  • 采用 GPL-3.0 许可证,这是一种 copyleft 许可证,会影响衍生作品的分发。
  • README 中引用的基准测试结果来自未包含在仓库中的评测工具。

收录于专题

标签

常见问题

tinycortex 是什么?
一个用 Rust 编写的本地优先 AI 记忆库,在写入时过滤低价值内容,并以 Markdown 为源提供可配置的检索。 TinyCortex 是一个开源的 Rust 库,为 AI 代理和应用提供记忆层。它不会把所有内容都存下来再按相似度召回,而是在写入时通过多信号准入门过滤低价值内容,让检索到的上下文更聚焦。
tinycortex 可以免费使用吗?用的什么许可证?
tinycortex 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
tinycortex 还在维护吗?
活跃维护中。tinycortex 最近一次提交是在 2026年11月2日。
tinycortex 适合用来做什么?
为用 Rust 编写的自定义 AI 代理添加长期记忆。 构建可直接以 Markdown 查看的本地优先知识库。 试验结合时效性与语义相关性的排序策略。
tinycortex 怎么安装和运行?
将 crate 及异步依赖添加到你的 Rust 项目: cargo add tinycortex anyhow 添加示例中所需运行时特性的 tokio: cargo add tokio --features macros,rt-multi-thread 在代码中使用内存后端存储并检索一条记忆
在哪里获取 tinycortex?
源代码和安装说明在 GitHub 上:https://github.com/tinyhumansai/tinycortex

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目