hashintel/hash

什么是 HASH？

HASH 是一个开源、自建的数据库，能将原始信息转化为结构化的 知识图谱（称为 world models）。它持续从公共网络来源和私人整合中获取数据，进行验证与链接，并使产生的实体和架构可供人类与自主 AI 代理搜索及使用。

核心理念

• 图谱支持的知识 – 数据以节点（实体）和边（关系）存储，并具有明确的架构（类型）。
• 双时态 (Bitemporality) – 每个事实都会记录 发生时间 与 获知时间，从而实现具备来源感知能力的查询。
• 自主代理 – 内置代理可以爬取网络、从 API 提取数据或同步私人来源，自动填充并检查图谱。
• 自我检查 – 系统会在接收新数据时验证架构的一致性与合规性。
• 高信任度的真理来源 – 下游应用程序可查询此图谱以进行决策、自动化或优化。

存储库结构

文件夹	用途
apps/	运行 HASH 平台的主要服务（API、前端、验证、工作流引擎等）。
blocks/	公共 Block Protocol 区块 – 可在项目间共享的可重复使用数据模型组件。
infra/	用于在本地运行或自托管整个堆栈的 Docker-Compose 文件与部署脚本。
libs/	共享函数库 – 服务所使用的 npm 套件与 Rust crates。
tests/	端对端与整合测试套件。

入门指南

快速开始（推荐）

1. 在 hash.ai 建立免费账户并登录。托管服务可在五分钟内启动一个现成的实例。

本地运行（开发者适用）

1. 安装 Git、Docker Compose、Docker Buildx 和 mise（版本管理器）。请确保 Docker 至少有 8 GB RAM。
2. 克隆存储库并安装锁定的工具链：

   git clone https://github.com/hashintel/hash.git && cd hash
   mise trust && mise install
   yarn install
   

3. 建立一个包含虚拟 API 密钥的 .env.local（仅 AI 功能需要）。
4. 启动支持服务：

   yarn compose up -d   # Postgres, Redis, Kratos, Hydra, Temporal, Vault, MinIO, Grafana 等。
   

5. 启动平台：

   # 开发最快方式 – 编译一次 Rust 图形，然后执行 API + 前端并启用热重载
   yarn start:graph   # 在终端机 1
   yarn dev           # 在终端机 2
   

   UI 将在 http://localhost:3000 提供。

如果您不需要编译 Rust 图形，可以使用 hgres 配置文件在 Docker 中运行。

主要组件

• API (hash-api) – REST/GraphQL 入口点，处理验证（通过 Kratos）、实体 CRUD 和工作流编排（Temporal）。
• 前端 (hash-web) – 基于 React 的 UI，用于浏览实体、编辑类型和管理代理。
• 图形引擎 – Rust 实现，将知识图谱存储在 PostgreSQL 中并提供快速查询能力。
• Temporal 工作流 – 背景工作程序，执行自主代理、数据获取管道和一致性检查。
• 验证堆栈 – Ory Kratos + Hydra，用于用户管理与 OAuth/OIDC。
• 可观测性 – Grafana 仪表板、Prometheus 指标与除错日志。

可扩展性与整合

• AI 提供商 – OpenAI、Anthropic（通过环境变量设定密钥）支持代理推理与摘要。
• 文件存储 – 默认本地文件系统；可透过 FILE_UPLOAD_PROVIDER 使用 AWS S3。
• 电子邮件 – 开发用虚拟传输器，或生产环境用的真实 SMTP / AWS SES。
• Block Protocol – 可从公共 Þ Hub 导入可重复使用的架构区块。

授权

大部分代码以宽松的开源授权发布（请参阅 LICENSE.md）。部分子组件可能有不同的条款，均列于授权文件中。

社区与支持

• 讨论与问题 – GitHub Discussions 与问题追踪器。
• 社交媒体 – 在 X（前身为 Twitter）上关注 @hashai。
• 招聘 – 公司会在网站上发布职位；贡献代码是获得关注的好方法。

---

简而言之： HASH 是一个全端、开源的平台，用于构建与维护即时、具备丰富来源信息的知识图谱，可供人类与 AI 代理查询。此存储库提供了在本地运行、自托管或使用 SaaS 版本所需的一切。