edgequake

用 Rust 把文档变成知识图谱，让 AI 检索更聪明

EdgeQuake 是一个用 Rust 编写的高性能 GraphRAG 引擎，灵感来自 LightRag。它专注于将文档转化为智能知识图谱，以支持更优的检索与生成。该项目解决了传统 RAG 在复杂关系理解上的不足，通过构建知识图谱来增强上下文关联，从而提升问答和生成的准确性。其核心能力包括高效的图构建、快速的相似性搜索以及与大语言模型的集成。由于采用 Rust 实现，EdgeQuake 在性能上具有显著优势，适合处理大规模文档集。项目目前处于成长阶段，社区和文档正在逐步完善。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2096

维护状态活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队raphaelmansuy

所属国家

官网地址https://edgequake.com

GitHubhttps://github.com/raphaelmansuy/edgequake

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自由使用和部署，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Rust

技术栈/模型graphrag,knowledge-graph,lightrag,rag

GitHub 星标★ 2096

30天Star增速

HF 下载量

上线时间2025-12-21 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：Docker 7 步

环境要求

已安装并运行 Docker（含 Docker Compose）
无需安装 Rust 或 Node.js，也不需要本地编译
准备 OpenAI API Key，或本地使用 Ollama 提供模型
可选：自备 PostgreSQL 实例（仅 API 模式需要）
可访问外网以拉取脚本与镜像

安装与启动步骤

1一键快速启动

执行官方 quickstart 脚本，交互式向导会引导选择模型提供方（OpenAI / Ollama）、选择模型，并拉起整套服务。
```
curl -fsSL https://raw.githubusercontent.com/raphaelmansuy/edgequake/edgequake-main/quickstart.sh | sh
```
2打开 Web 界面

容器启动后浏览器访问 http://localhost:3000 即可进入，无需登录（快速启动以开放 API 模式运行）。

3下载 Compose 文件

如果不想用向导，可直接使用官方提供的 quickstart compose 文件，先下载到当前目录。

curl -fsSL https://raw.githubusercontent.com/raphaelmansuy/edgequake/edgequake-main/docker-compose.quickstart.yml -o docker-compose.quickstart.yml

4用 Compose 启动

在下载好 compose 文件的目录执行，后台启动全部服务，效果与一键脚本一致。
```
docker compose -f docker-compose.quickstart.yml up -d
```
5无交互环境启动

CI 或无终端场景下，用环境变量传入提供方与密钥，避免向导交互。需先有 quickstart compose 文件。
```
EDGEQUAKE_LLM_PROVIDER=openai OPENAI_API_KEY=sk-xxxxxxxx docker compose -f docker-compose.quickstart.yml up -d
```

6仅启动 API 服务

只跑后端 API 容器，映射 8080 端口，数据库需自备并传入 DATABASE_URL，适合已有 PostgreSQL 的场景。

docker run -d --name edgequake -p 8080:8080 -e DATABASE_URL="postgres://user:pass@your-db:5432/edgequake" -e EDGEQUAKE_LLM_PROVIDER=openai -e OPENAI_API_KEY="sk-xxxxxxxx" ghcr.io/raphaelmansuy/edgequake:latest

7全栈预构建镜像

进入仓库 docker 目录，复制环境变量模板后启动预构建全栈（API 8080、前端 3000、PostgreSQL 5432）。
```
cd edgequake/docker
cp .env.example .env
docker compose -f docker-compose.prebuilt.yml up -d
```

关键配置

配置项	必填	说明	示例
`EDGEQUAKE_LLM_PROVIDER`	是	指定大模型提供方，快速启动向导支持 OpenAI 或 Ollama	`openai`
`OPENAI_API_KEY`	是	使用 OpenAI 作为提供方时必填的 API 密钥	`sk-xxxxxxxx`
`DATABASE_URL`	否	仅 API 模式下的 PostgreSQL 连接串	`postgres://user:pass@your-db:5432/edgequake`
`EDGEQUAKE_DEV_MODE`	否	快速启动会设为 true，以开放 API 方式运行且无需登录	`true`

如何确认成功

浏览器打开 http://localhost:3000 能正常进入 Web UI（无需登录）即为启动成功；仅 API 模式则端口为 8080。

常见问题

Q：需要先安装 Rust 或 Node.js 吗？

A：不需要。README 明确说明无需 Rust、无需 Node.js、无需构建，只要有 Docker 即可完成部署。

Q：Web 界面端口是多少，会不会和其他服务冲突？

A：Docker 快速启动把 Web UI 映射到 3000；本地 make dev 默认用 3010，可避免与其他服务栈端口冲突。

Q：没有交互终端时怎么启动？

A：在命令前通过环境变量传入 EDGEQUAKE_LLM_PROVIDER 与 OPENAI_API_KEY 等参数，再执行 docker compose up -d，适用于 CI 环境。

Q：可以用什么数据库版本？

A：预构建 PostgreSQL 镜像默认 PG18，同时提供 pg17、pg16 的多架构标签（amd64 + arm64），按标签选择即可。

注意事项

快速启动通过 EDGEQUAKE_DEV_MODE=true 以开放 API 运行、无登录，适合本地试用，不要直接暴露到公网。
仅 API 模式需要你自备可用的 PostgreSQL，并正确填写 DATABASE_URL。
预构建全栈镜像涉及端口 3000（前端）、8080（API）、5432（PostgreSQL），启动前确认未被占用。
镜像版本示例为 0.21.0 与 :latest，生产环境建议固定具体版本标签而非 latest。

核心亮点

基于 Rust 实现，性能远超 Python 同类项目，处理大规模文档更高效
借鉴 LightRag 的成熟设计，GraphRAG 能力扎实，检索准确度有保障
自动构建知识图谱，无需手动标注，降低使用门槛

不足之处

项目较新，文档和示例相对有限，上手需要一定摸索
生态尚不成熟，周边工具和社区支持不如 Python 系丰富

适用场景

企业级知识库构建，需要快速处理海量文档并支持复杂查询
智能问答系统，需要理解实体间关系以提供精准答案
研究或生产环境中的 RAG 应用，追求高性能和低延迟

替代项目

LightRAG、Microsoft GraphRAG、NebulaGraph

项目介绍

edgequake 是搜索知识领域的开源项目，由 raphaelmansuy 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,096）位列前 30%，在搜索知识分类中处于中上游。

近 42 天，它的 GitHub 星标从 2,068 增加到 2,096，净增 28。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可自由使用和部署，无付费版本。

它主要面向的使用场景是：企业级知识库构建，需要快速处理海量文档并支持复杂查询。同类可对比的替代方案包括 LightRAG、Microsoft GraphRAG、NebulaGraph。

上一篇：MemoRAG

下一篇：agentset