项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 143902
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 环境(README 建议用 uv 统一管理,无需手动装 pip 包)
- uv 包管理工具(curl -LsSf https://astral.sh/uv/install.sh | sh 安装)
- 可访问 PyPI 与 astral.sh 的网络
- 仅开发/跑测试时需要 git,普通使用不需要
安装与启动步骤
-
1安装 uv 工具
uv 是官方推荐的安装与运行方式,先在本机装上;已安装过可跳过此步。
curl -LsSf https://astral.sh/uv/install.sh | sh -
2安装 graphify 命令行
注意 PyPI 包名是双 y 的 graphifyy,装完后命令仍是 graphify,别装错同名包。
uv tool install graphifyy -
3确认命令可用
若终端提示找不到 graphify,执行 update-shell 刷新工具路径后重开终端。
uv tool update-shell -
4团队共享图谱产物
graphify-out/ 目录设计为可提交到 git,让同事一开始就有同一份图谱。
-
5开发环境(可选)
需要改源码或跑测试时,克隆仓库并切到 v8 开发分支,用 uv 管理虚拟环境。
git clone https://github.com/safishamsi/graphify.git cd graphify git checkout v8 -
6运行测试(可选)
开发模式下用 uv run pytest 执行测试套件,可加 -k 按名称过滤。
uv run pytest tests/ -q
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
graphify-out/cost.json | 否 | 本地成本记录文件,建议加入 .gitignore 不提交 | graphify-out/cost.json |
graphify-out/ | 否 | 图谱输出目录,建议提交到 git 供团队共用 | graphify-out/ |
如何确认成功
在终端执行 graphify,能正常输出命令行帮助信息即表示安装成功;若报找不到命令,先执行 uv tool update-shell。
常见问题
Q:装完提示找不到 graphify 命令怎么办?
A:执行 uv tool update-shell 刷新 shell 路径配置,然后重开终端再试;确认安装的是双 y 的 graphifyy 包。
Q:PyPI 上有很多 graphify 开头的包,该装哪个?
A:官方包是 graphifyy(双 y),README 明确说明其他 graphify* 包与本项目无关,CLI 命令名仍为 graphify。
Q:团队成员怎么共享同一份知识图谱?
A:把 graphify-out/ 目录提交到 git,其他人克隆后即可直接使用同一份图谱,只把 graphify-out/cost.json 加入 .gitignore。
Q:怎么参与开发或跑测试?
A:克隆仓库后 git checkout v8 切到开发分支,项目用 uv 管理依赖,执行 uv run pytest tests/ -q 可跑完整测试。
注意事项
- PyPI 包名 graphifyy 与命令名 graphify 不一致,容易装错,务必按 README 指定的包名安装。
- README 节选未给出生成图谱、查询图谱的具体命令与参数,本教程只覆盖安装与验证部分。
- graphify-out/ 默认应纳入版本库,但 cost.json 属于本地文件不要提交。
核心亮点
- 基于确定性AST解析而非向量检索,可解释性强且无需向量数据库依赖
- 每条图谱边自带来源说明,便于追踪代码关系与生成依据
- 适配Claude Code、Cursor、Codex、Gemini CLI等多类AI工具,天然兼容Agent工作流
不足之处
- 大规模代码库下的解析性能与内存占用缺少实测数据,有待评估
- 当前更偏向代码结构关系,对运行时行为、动态调用等语义覆盖有限
- 文档/社区待观察
适用场景
- 将大型代码库构建为可查询知识图谱,辅助AI Agent理解项目结构
- 结合SQL Schema、配置和PDF文档,构建跨类型知识的统一检索入口
- 在无向量存储环境中实现轻量级代码问答与关系推理
替代项目
microsoft/graphrag、neo4j/llm-graph-builder、ast-grep
同类项目推荐
StruInfo
开源
把文档变成可追溯、可编辑的知识图谱,数据自己掌控
Self-hosted, traceable document-to-knowledge workspace with deterministic workflows,···
meilisearch
开源
几分钟接入毫秒级搜索,还带 AI 混合检索
A lightning-fast search engine API bringing AI-powered hybrid search to your sites a···
local-rag-llamaindex
开源
本地跑通论文问答,快速定位研究要点
Local llamaindex RAG to assist researchers quickly navigate research papers
Awesome-World-Models
开源
一页看懂世界模型论文、代码与落地方向
A comprehensive list of papers for the definition of World Models and using World Mo···
BYO-LLM-WIKI
开源
用大模型自动构建你的知识库,还能自动生成技能
Build your own LLM-native WIKI (knowledge library). Search, extract, summarize, Q&A ···
bRAG-langchain
开源
跟着教程一步步搭出你自己的 RAG 问答系统
Everything you need to know to build your own RAG application
daily-paper-reader
开源
每天自动推 arXiv 论文,AI 帮你读摘要答问题
开源的每日 arXiv / OpenReview 论文推荐与 AI 阅读平台,支持 GitHub Actions 自动更新、···
pg_vectorize
开源
在 Postgres 里直接搞定全文+语义搜索,不用额外部署向量库
Full-text and semantic search on any Postgres
GEORank
开源
追踪内容在生成式搜索中的排名与引用表现
Open-source GEO ranking and generative engine optimization platform.
