graphify

整个代码库画成一张图,找问题一眼定位

开源 🏷️定价信息待确认 ✅ 目前可打开 开源模型 🍴 复刻 13764 🐛 待处理 1654 👀 关注 413
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 143902
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

graphify 项目界面预览图
图片来源:项目官网

项目数据

分类开源模型
开发团队Graphify-Labs
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型ai-agents,antigravity,ast,claude-code,code-analysis,code-search,codex,cursor,developer-tools,gemini,graphify,graphrag,knowledge-graph,leiden,llm,mcp,openclaw,rag,skills,tree-sitter
GitHub 星标★ 143902
上线时间2026-04-03 00:00:00
代码更新2026-11-06
仓库体积31.7 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数29

项目介绍

将代码库、文档、SQL 模式、配置和 PDF 转化为可查询的知识图谱,基于本地确定性 AST 解析,每条边都有解释,无需向量库,适配 Claude Code、Cursor 等工具。

Star 增长趋势

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

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

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 8 分钟 部署方式:命令行工具 6 步

环境要求

  • Python 环境(README 建议用 uv 统一管理,无需手动装 pip 包)
  • uv 包管理工具(curl -LsSf https://astral.sh/uv/install.sh | sh 安装)
  • 可访问 PyPI 与 astral.sh 的网络
  • 仅开发/跑测试时需要 git,普通使用不需要

安装与启动步骤

  1. 1安装 uv 工具

    uv 是官方推荐的安装与运行方式,先在本机装上;已安装过可跳过此步。

    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 2安装 graphify 命令行

    注意 PyPI 包名是双 y 的 graphifyy,装完后命令仍是 graphify,别装错同名包。

    uv tool install graphifyy
  3. 3确认命令可用

    若终端提示找不到 graphify,执行 update-shell 刷新工具路径后重开终端。

    uv tool update-shell
  4. 4团队共享图谱产物

    graphify-out/ 目录设计为可提交到 git,让同事一开始就有同一份图谱。

  5. 5开发环境(可选)

    需要改源码或跑测试时,克隆仓库并切到 v8 开发分支,用 uv 管理虚拟环境。

    git clone https://github.com/safishamsi/graphify.git
    cd graphify
    git checkout v8
  6. 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

上一篇:ask.py

下一篇:KAG

同类项目推荐

StruInfo 开源

把文档变成可追溯、可编辑的知识图谱,数据自己掌控

Self-hosted, traceable document-to-knowledge workspace with deterministic workflows,···

★ 91 2026-10-09
meilisearch 开源

几分钟接入毫秒级搜索,还带 AI 混合检索

A lightning-fast search engine API bringing AI-powered hybrid search to your sites a···

★ 59808 2026-10-11
local-rag-llamaindex 开源

本地跑通论文问答,快速定位研究要点

Local llamaindex RAG to assist researchers quickly navigate research papers

★ 135 2026-08-09
Awesome-World-Models 开源

一页看懂世界模型论文、代码与落地方向

A comprehensive list of papers for the definition of World Models and using World Mo···

★ 2053 2026-09-29
BYO-LLM-WIKI 开源

用大模型自动构建你的知识库,还能自动生成技能

Build your own LLM-native WIKI (knowledge library). Search, extract, summarize, Q&A ···

★ 276 2026-08-09
bRAG-langchain 开源

跟着教程一步步搭出你自己的 RAG 问答系统

Everything you need to know to build your own RAG application

★ 4197 2026-08-09
daily-paper-reader 开源

每天自动推 arXiv 论文,AI 帮你读摘要答问题

开源的每日 arXiv / OpenReview 论文推荐与 AI 阅读平台,支持 GitHub Actions 自动更新、···

★ 976 2026-09-16
pg_vectorize 开源

在 Postgres 里直接搞定全文+语义搜索,不用额外部署向量库

Full-text and semantic search on any Postgres

★ 835 2026-08-09
GEORank 开源

追踪内容在生成式搜索中的排名与引用表现

Open-source GEO ranking and generative engine optimization platform.

★ 533 2026-11-03