Quipu

Quipu

受治理的知识，供你的 Agent 阅读、复用和共享

Apache-2.0 · CI · 阅读手册

Quipu 是面向 AI Agent 及其运营者的受治理双时态知识存储。 可通过命令行、REST、MCP 或 Rust 应用使用。 quipu 是安第斯地区以打结绳索记录信息的方式：绳索代表实体，绳结代表事实。

为什么需要它

• 受治理： 根据你的词汇表和结构校验传入的知识。
• 双时态： 保留可查询的事实和决策历史。
• 可复用的 Agent 知识： 存储 Agent 可跨工具阅读、复用和共享的记忆。
• 感知时间的实体： 附加事件触发时间属性，供 Chaski 响应。

将 Quipu 用作许多工具的中央图谱和基础：参见技术栈。 完整的使用理由请见为什么选择 Quipu。

安装

curl -fsSL https://raw.githubusercontent.com/intigraph/quipu/main/install.sh | sh

适用于 Linux 和 macOS，支持 x86_64 和 arm64；需要 Python 3.9+ 和 curl。 安装程序会验证已发布归档的校验和以及可执行文件版本。 然后运行 quipu --version。安装、升级或移除 Quipu。 要使用完整技术栈，请通过 Tambo 引导式入门。

三条命令，首次成功

在空目录中，获取公开示例数据，存储其事件，然后查询其中的关系：

curl -fsSL https://raw.githubusercontent.com/intigraph/quipu/main/docs/demos/terminal/fixture/episode.json -o episode.json
quipu episode episode.json --base-ns urn:demo: --timestamp 2026-01-01T00:00:00Z --db demo.db
quipu read 'SELECT ?person ?thing WHERE { ?person <urn:demo:studies> ?thing }' --db demo.db

查询结果为 Ada → Engine。以下展示了真实的本地事件和查询：

生成的行，以绳索和绳结绘制：

录制使用本地公开示例数据，无需服务或模型。保留了原生警告：加载事实并不能证明语义索引已就绪。 文字稿、工具版本和可复现的录制过程。

在你自己的代码中使用

将项目事实、决策和关系集中管理，而不是把相同的上下文粘贴到每个 Agent 中。

你的需求	从这里开始
加载事实并应用你的词汇表	快速入门
查询当前或历史知识	SPARQL 和时间
共享受治理的知识包	经过验证的共享
准备领域知识和结构	Camayoc

### 仓库知识

最新版本包含一个仓库挂件、校验和与来源证明。请一并验证它们，然后运行 quipu import SHARE_DIR --db repository.db；导入会暂存知识，并保持 ROOT 不变。请遵循已验证的导入工作流。

交付事件

将部署结果和变更历史纳入同一受治理记忆。 这些适配器基于 CloudEvents 上的 CDEvents，并使用 Camayoc 的单一入口。

目录数据 · 更新表格

工具	标准	方式	状态	文档
GitHub / Forgejo Actions	CloudEvents 上的 CDEvents	可复用的部署事件 action 或 CLI；跳过和取消的作业不会发出部署事件。	支持的适配器；需单独启用	指南
Ansible	CloudEvents 上的 CDEvents	回调会为每台已应用变更的主机写入一个事件；汇总中失败或不可达的计数表示失败。	支持的适配器；需单独启用	指南
Terraform	CloudEvents 上的 CDEvents	封装实际的 apply -json；在尝试变更后出现错误或退出码非零表示失败。	支持的适配器；需单独启用	指南
原生 CDEvents	CloudEvents 上的 CDEvents	通过唯一的受治理入口传递受支持的 CDEvents；未知类型会被隔离。	支持的适配器；需单独启用	指南
GitHub 变更生命周期	CloudEvents 上的 CDEvents	将变更、CI 和原生评审记录读入 ChangeEvent 历史；调度需单独配置。	支持的适配器；需单独启用	指南

目录描述的是来源支持情况，而非已安装的生产者或测得的事件覆盖范围。 用于查询部署频率、变更失败率、前置时间和恢复时间的图查询 需要选定服务、仓库和时间窗口内记录的事件。 缺少变更或部署历史，并不代表测得的数值为零。

接入你的 Agent

对于 Claude Code，请将本地 MCP 服务连接到数据库：

claude mcp add quipu -- quipu mcp --db /path/to/knowledge.db

MCP Registry 标识符为 mcp-name: io.github.intigraph/quipu。 其他客户端、HTTP MCP 和凭据配置：请参阅 Agent 设置。 使用 Tambo 配置并验证这些工具。

开始之前

• CLI 在本地运行；quipu-server 提供网络 API 和浏览器。
• 请妥善保管数据库和凭据。演示数据不等同于部署配置。
• 语义搜索需要配置模型和索引；仅存储图谱并不能提供其中任何一项。
• 配置介绍存储和服务设置。

接下来

• Quipu 手册：教程、概念和参考资料。
• 快速入门：受治理的本地示例。
• 领域形状：由生产者维护的词汇表。
• Stack README 格式和共享主视觉主题。

🧺 技术栈

Tambo 会一并安装这些工具，并验证每个工具都能正常工作；每个工具也都可以独立使用。 请参阅各工具的 README，了解安装方法和首次运行步骤。

Quipu 技术栈围绕一个受治理的双时态知识存储构建：Agent 可查询共享事实、决策和工作历史。Quipu 可以根据你的规则检查写入内容，记录每条事实的来源，并回答某个时间点哪些内容为真。

工具	为你的 Agent 提供的功能
tambo	🧰 Agent 平台工具包——安装和配置 Quipu 技术栈
quipu	存储带有来源信息和历史记录的共享事实；可根据你的规则检查写入内容
camayoc	为 Quipu 准备知识和词汇，并在纳入前进行检查
quechua	用于实现知识互操作的共享词汇和结构
chaski	对图谱变更作出响应，并发送受治理的通知
bobbin	为代码库建立索引，并从该索引和 Quipu 知识中注入上下文
yupana	展示代码影响，并可读取 Quipu 中的策略来治理 Agent 操作
desire-path	将 Agent 的错误转化为功能请求；无需 Quipu 即可独立运行
seeds	由 Quipu 知识库支持的工作项跟踪工具
shantytown	运行由 AI Agent 组成的团队来处理工作项，可手动触发、按计划运行或由事件触发；可通过 Quipu 共享工作和记忆
rikuy	实时简报：Quipu 上的状态、图表、监视项和签名决策
shuttle	运行签名的 Agent 工作流，并将记录保存在 Quipu 中

贡献

请参阅 CONTRIBUTING.md。此代码库的检查项如下：

just check
just docs check

📜 许可证

Apache-2.0。