Repolode
提交项目
nowledge-co

nowledge-co/hawdb

面向 AI 智能体的嵌入式 Rust 数据库，在同一引擎中统一存储图、关系、文本与向量数据。

在 GitHub 查看官网
Star
203
Fork
13
未关闭 Issue
138
最近提交
10小时前

这是什么？

HawDB 是一个面向智能体的嵌入式数据库，把实体、关系、文档和事件保存在同一个崩溃安全的进程内，并以有上限的上下文形式返回结果。图结构、关系表、全文检索和向量检索共用一个引擎，检索请求依次经过搜索候选、过滤、带权限校验的图扩展、重排序，最后从固定快照中取回完整内容。

智能体可以通过参数化 Cypher 和 PostgreSQL 方言 SQL 进行查询。每次读取都有明确的行数和数据量上限，超出上限的请求会直接失败，而不是悄悄返回被截断的结果。写时复制分支允许智能体在自己的持久副本上工作，无需复制整个数据库，因此可以在不影响主分支和其他智能体的情况下试验计划。

该库使用 Rust 编写，采用 Apache-2.0 许可证，Python 绑定以 hawdb 包名发布在 PyPI 上。它为 Nowledge Mem 而构建，也适合作为库嵌入任何需要持久化上下文层的宿主程序。

核心功能

  • 01图、关系表、全文检索和向量检索共用同一个嵌入式引擎。
  • 02同一句柄上同时支持参数化 Cypher 和 PostgreSQL 方言 SQL。
  • 03读取有明确的行数和数据量上限，超限时直接失败而非截断结果。
  • 04为智能体提供写时复制分支，创建时不复制父级数据。
  • 05通过预写日志实现崩溃恢复，每个数据库目录只允许一个写入进程。
  • 06提供发布在 PyPI 上的 Python 绑定 hawdb。

适用场景

  • 为 AI 智能体提供可持久化、可查询的实体与关系记忆。
  • 让智能体在独立分支上试验多步计划，确认后再回写结果。
  • 在 Rust 或 Python 应用中嵌入一个支持有界检索的上下文存储。

快速上手

  1. 1

    在 Cargo.toml 中添加 hawdb crate

  2. 2

    从源码检出目录构建默认库

    cargo build --locked -p hawdb

使用前须知

  • 它只是 Rust 库，应用需通过 Rust 或仓库内的 Python 绑定进行集成。
  • 项目处于早期阶段（版本 0.25），仅有 197 个星标，README 称其仍处于 Nowledge Mem 的每夜集成阶段。
  • 每个数据库目录同一时间只能由一个进程持有。

收录于专题

开源 AI Agent 框架与应用

标签

#graph-database#embedded-database#vector-search#rust#agents#knowledge-graph#cypher#graph#graph-algorithms#memory-database

常见问题

hawdb 是什么？
面向 AI 智能体的嵌入式 Rust 数据库，在同一引擎中统一存储图、关系、文本与向量数据。 HawDB 是一个面向智能体的嵌入式数据库，把实体、关系、文档和事件保存在同一个崩溃安全的进程内，并以有上限的上下文形式返回结果。图结构、关系表、全文检索和向量检索共用一个引擎，检索请求依次经过搜索候选、过滤、带权限校验的图扩展、重排序，最后从固定快照中取回完整内容。
hawdb 可以免费使用吗？用的什么许可证？
hawdb 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
hawdb 还在维护吗？
活跃维护中。hawdb 最近一次提交是在 2026年11月7日。
hawdb 适合用来做什么？
为 AI 智能体提供可持久化、可查询的实体与关系记忆。 让智能体在独立分支上试验多步计划，确认后再回写结果。 在 Rust 或 Python 应用中嵌入一个支持有界检索的上下文存储。
hawdb 怎么安装和运行？
在 Cargo.toml 中添加 hawdb crate 从源码检出目录构建默认库: cargo build --locked -p hawdb
在哪里获取 hawdb？
源代码和安装说明在 GitHub 上：https://github.com/nowledge-co/hawdb

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

相关项目