Kwipu

本地跑通 Graph RAG，让 Markdown 笔记直接问出答案

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 60 🐛 待处理 3 👀 关注 1

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 610

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费完全开源免费，MIT许可证，本地部署，无云服务，无付费版本。

项目预览

项目数据

分类搜索知识

开发团队benmaster82

官网地址https://benmaster82.github.io/Kwipu

GitHubhttps://github.com/benmaster82/Kwipu

定价模式🏷️完全免费

价格说明完全开源免费，MIT许可证，本地部署，无云服务，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型claude-code,embeddings,graph-rag,knowledge-graph,llama-index,llm,markdown,mcp,mcp-tools,md,natural-language,obsidian,obsidian-notes,obsidian-vault,offline,offline-first,ollama,rag,rag-chatbot,terminal-ui

GitHub 星标★ 610

上线时间2026-04-21 00:00:00

代码更新2026-11-02

仓库体积1.5 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-08-09

浏览次数3

项目介绍

Kwipu 是一个完全本地化的 Graph RAG 引擎，专为 Obsidian 笔记库设计，也可处理任意 Markdown 文件夹。它从 wikilinks 和 YAML frontmatter 中提取实体-关系三元组，构建知识图谱，并通过混合搜索（向量 + BM25 + 时间）检索答案。支持多语言，无需云端，依赖 Ollama 运行本地模型。解决的是笔记分散、难以跨文档关联和问答的问题，核心能力包括本地知识图谱构建、混合检索和基于上下文的问答。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 610

技术标签

claude-code embeddings graph-rag knowledge-graph llama-index

使用教程

难度：进阶约 45 分钟部署方式：本地安装 4 步

环境要求

Python 3.10+
Node.js
文档目录或笔记库

安装与启动步骤

1克隆装依赖

前后端分离，Python 侧依赖要单独装。
```
git clone https://github.com/benmaster82/Kwipu.git
```
2先把图建出来

它把文档抽成属性图，这步决定后面能不能查准。
```
python geode_graph.py --fast
```
3起桥接服务

界面与图之间隔着一层服务，缺了打不开。
```
python -m bridge
```
4换成本地模型

默认可能连云端，换本地模型省钱也更私密。
```
python geode_graph.py --llm-model qwen2.5:7b --embed-model nomic-embed-text
```