graphify

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

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

开源 unknown 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 120493
维护状态 活跃
是否开源
定价模式 unknown

项目数据

分类开源模型
开发团队Graphify-Labs
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源
开源协议Apache-2.0
主要语言Python
技术栈/模型ai-agents,antigravity,ast,claude-code,code-analysis,code-search,codex,cursor,developer-tools,gemini,graphrag,knowledge-graph,leiden,llm,mcp,openclaw,rag,skills,tree-sitter
GitHub 星标★ 120493
30天Star增速
HF 下载量
上线时间2026-04-03 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数11

使用教程

难度:入门 约 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

项目介绍

graphify 是搜索知识领域的开源项目,由 Graphify-Labs 开发,是 2026 年新上线的项目。

在全站 13,014 个收录项目中,它的 GitHub 星标数(120,493)位列前 1%,在搜索知识分类的 581 个项目里位列前 1%。

近 44 天,它的 GitHub 星标从 104,543 增加到 120,493,净增 15,950。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。从国内网络环境看,可直接访问。

它主要面向的使用场景是:将大型代码库构建为可查询知识图谱,辅助AIAgent理解项目结构。同类可对比的替代方案包括 microsoft/graphrag、neo4j/llm-graph-builder、ast-grep。

上一篇:ask.py

下一篇:KAG

同类项目推荐

firecrawl 开源

网页抓取像喝水一样简单,开发者省下整周加班

The web data API to search, scrape, and interact at scale.

★ 183325 2026-08-09
contoso-chat 开源

一键跑通 Azure RAG 应用,从代码到评估部署全流程

This sample has the full End2End process of creating RAG application with Prompty an···

★ 766 2026-08-09
graphify 开源

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

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···

★ 120493 2026-08-09
qiaomu-youtube-ai-podcast 开源

一站式索引AI播客,快速找到有文字稿和总结的节目

AI 播客索引:整理 AI 播客、中文简介、Transcript 状态和总结入口 | Curated AI podcast ···

★ 69 2026-08-09