知识库问答 · 中文选型解读

graphify

已解读GitHubApache-2.0Python

这是一款可将代码库、文档、SQL schema、PDF等资产转换为可查询知识图谱的工具,适配多款主流AI编码助手,支持代码本地解析。

112.9kstar1 天前更新维护状态Apache-2.0 · 可评估商用商用提醒
在 GitHub 查看官方项目
适合解决把企业文档和数据变成可追溯的 AI 问答能力
更适合有文档沉淀、客服或内部知识复用需求的团队
投入判断上手门槛:需评估。通常需要整理数据、配置模型与权限
一分钟看懂

这个项目值得继续研究吗?

AI 依据上游资料解读 · 2026/8/30

这是一款可将代码库、文档、SQL schema、PDF等资产转换为可查询知识图谱的工具,适配多款主流AI编码助手,支持代码本地解析。

解决什么问题
企业研发团队面对分散的代码、文档、配置、PDF等多类技术资产,梳理系统逻辑、查找关联关系成本高,传统检索方式效率低,人工梳理易出错,跨资产关联难以快速追溯。
适合什么团队
适合有一定研发基础的企业技术团队,包括需梳理复杂代码资产的研发组、搭建内部技术知识体系的架构与运维团队。
使用前注意
部署需提前安装Python 3.10及以上版本,官方PyPI包名为graphifyy(双y),代码解析全本地,文档、音视频语义解析需自行配置AI模型API。

本页用于缩短初步筛选时间,不构成技术、采购或法律结论。 正式使用前请在真实业务数据上验证,并以官方说明与许可证为准。

项目导读

从官方资料看清能力、部署与采用边界

AI 翻译整理 · 保留官方来源

以下内容依据项目公开 README 或模型卡翻译整理,代码、命令和产品名保持原样。

项目定位

graphify是一款面向技术资产梳理的知识图谱(一种用节点代表实体、边代表实体间关联关系的结构化知识表示方式)生成工具,核心是把企业分散的代码、SQL schema、配置文件、文档、PDF甚至音视频等不同类型的技术资产,转换成统一的可查询知识图谱,替代传统的文件检索方式,帮助团队快速梳理系统逻辑、定位关联关系。它适配Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot等15款以上主流AI编码助手,可直接作为助手技能调用。

核心能力

  1. 本地确定性代码解析:采用tree-sitter AST(抽象语法树,将代码结构转化为树形节点的标准化表示方式)解析代码,完全在本地运行,不需要调用大模型,代码不会流出企业环境,解析结果确定可复现,构建代码图谱全程无大模型token消耗。
  2. 关联关系可溯源:所有节点之间的连接都标注EXTRACTED(直接从源文件提取的显式关联)或INFERRED(工具推导的关联),用户可清晰判断关联可信度,避免推导信息干扰判断。
  3. 真实图谱而非向量索引:不需要生成向量嵌入、不需要向量数据库,是可直接遍历的真实知识图谱,支持查询、路径追溯、概念解释三类核心操作,在长上下文问答场景下准确率可达76%,与密集RAG(检索增强生成,一种将外部知识库信息引入大模型问答的技术)效果持平。
  4. 多类型资产统一纳入:除了代码,还支持把文档、PDF、图片、音视频等资产的语义信息纳入同一个图谱,实现跨资产关联查询;代码中的# NOTE:/# WHY:注释、架构决策记录、需求文档引用也会作为一级节点和对应代码关联。
  5. 自动识别核心节点与子系统:自动识别关联度最高的核心概念节点,用Leiden算法拆分图谱为不同的子系统模块,无需大模型即可生成模块标签,帮助团队快速理解系统结构。

典型使用方式

工具安装与使用流程非常简单,全程仅需几步:

  1. 安装CLI工具:推荐用uv包管理器安装,执行uv tool install graphifyy即可,也可以选择pipx或pip方式安装。
  2. 注册到AI助手:执行graphify install即可完成技能注册,直接在AI助手中调用;如果需要给单个项目单独配置,加上--project参数即可,配置文件可提交到代码仓库共享给团队成员。

调用时在AI助手输入/graphify .即可自动扫描当前目录的所有资产生成图谱,最终输出三个文件:

  • graph.html:可在任意浏览器打开的可视化图谱,支持点击节点、筛选、搜索操作
  • GRAPHREPORT.md:核心亮点总结,包括关键概念、意外关联、建议查询问题
  • graph.json:完整的图谱数据,可随时查询无需重新扫描文件

常用的查询命令包括:

  • graphify explain "概念名":查看某个概念的详情和所有关联关系
  • graphify path "A" "B":查找两个概念之间的最短关联路径
  • graphify query "自然语言问题":返回对应问题的相关子图谱

部署与运行要求

部署前需要提前准备Python 3.10及以上版本,推荐配套安装uv包管理器,不同操作系统的快速安装方式如下:

  • macOS(Homebrew):执行brew install python@3.12 uv
  • Windows:执行winget install astral-sh.uv
  • Ubuntu/Debian:可执行sudo apt install python3.12 python3-pip pipx,也可通过官方脚本安装uv

注意官方PyPI包名为graphifyy(双y),其余同名包均非官方出品,请勿安装错。

项目状态与许可证

项目当前处于活跃开发状态,未归档,默认分支为v8版本,官方SaaS平台的v1正式版尚未发布,目前开放早期访问,可登录app.graphify.com体验后台自动同步更新的全量功能。项目采用Apache-2.0开源许可,允许企业自由使用、修改、二次分发,包括商用场景。

采用建议

如果你的团队需要梳理复杂的历史代码库、搭建统一的技术资产知识库、降低新人熟悉系统的成本,或者需要频繁排查跨模块的关联问题,可以优先试用该工具。代码解析完全在本地运行,不会泄露代码资产;如果需要纳入文档、音视频等非代码资产,需要自行配置对应的AI模型API,相关数据会传给你配置的模型服务商,可根据企业数据安全要求选择是否开启该功能。

可核对的事实层

官方资料与来源

查看来源 →
  • ai-agents
  • antigravity
  • ast
  • claude-code
  • code-analysis
  • code-search
  • codex
  • cursor
  • developer-tools
  • gemini
  • graphrag
  • knowledge-graph
默认分支v8
关注仓库369
复刻次数10.9k
开放议题1.2k
近期更新2026/8/29
仓库状态未标记归档
上游部署线索
## Prerequisites

| Requirement | Minimum | Check | Install |
|---|---|---|---|
| Python | 3.10+ | `python --version` | [python.org](https://www.python.org/downloads/) |
| uv *(recommended)* | any | `uv --version` | `curl -LsSf https://astral.sh/uv/install.sh \| sh` |
| pipx *(alternative)* | any | `pipx --version` | `pip install pipx` |

**macOS quick install (Homebrew):**
```bash
brew install python@3.12 uv
```

**Windows quick install:**
```powershell
winget install astral-sh.uv
```

**Ubuntu/Debian:**
```bash
sudo apt install python3.12 python3-pip pipx

该片段来自项目 README,仅用于初步判断;实际部署请以官方文档为准。

核对上游原始说明节选

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

Read this in other languages

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇩🇪 Deutsch | 🇫🇷 Français | 🇪🇸 Español | 🇮🇳 हिन्दी | 🇧🇷 Português | 🇷🇺 Русский | 🇸🇦 العربية | 🇮🇷 فارسی | 🇮🇹 Italiano | 🇵🇱 Polski | 🇳🇱 Nederlands | 🇹🇷 Türkçe | 🇺🇦 Українська | 🇻🇳 Tiếng Việt | 🇮🇩 Bahasa Indonesia | 🇸🇪 Svenska | 🇬🇷 Ελληνικά | 🇷🇴 Română | 🇨🇿 Čeština | 🇫🇮 Suomi | 🇩🇰 Dansk | 🇳🇴 Norsk | 🇭🇺 Magyar | 🇹🇭 ภาษาไทย | 🇺🇿 Oʻzbekcha | 🇹🇼 繁體中文 | 🇵🇭 Filipino | 🇮🇱 עברית

Early access to the graphify platform is open before the public v1 launch: app.graphify.com

Type /graphify in your AI coding assistant and it maps your entire project (code, docs, PDFs, images, videos) into a knowledge graph you can query instead of grepping through files.

  • Code maps for free, fully local. Code is parsed with tree-sitter AST: deterministic, no LLM, nothing leaves your machine. (Docs, PDFs, images and video use your assistant's model, or a configured API key, for a semantic pass.)
  • Every edge is explained. Each connection is tagged EXTRACTED (explicit in the source) or INFERRED (resolved by graphify), so you can tell what was read directly from what was inferred.
  • Not a vector index. No embeddings, no vector store: a real graph you traverse. Ask a question, trace the path between two things, or explain one concept.
Want this always-on, updating in the background across your code, docs, and meetings rather than only on demand? That is what we are building at graphify.com, and early access is open now at app.graphify.com.

The FastAPI codebase mapped by graphify. Every node is a concept, colors are detected communities, and the whole thing is clickable in graph.html.

Get started (30 seconds):

uv tool install graphifyy      # install the CLI (or: pipx install graphifyy)
graphify install               # register the skill with your AI assistant

Then, in your AI assistant:

/graphify .

That's it. You get three files:

graphify-out/
├── graph.html       open in any browser — click nodes, filter, search
├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions
└── graph.json       the full graph — query it anytime without re-reading your files

Works in Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, and 15+ more — pick your platform.

What it does

What you get out of the box:

| Capability | What you get | |---|---| | God nodes | The most-connected concepts, so you see what everything flows through | | Communities | The graph split into subsystems (Leiden), with LLM-free labels | | Cross-file links | calls / imports / inherits / mixesin resolved across 40 languages via tree-sitter AST | | Query, path, explain | Ask a question, trace the path between two things, or explain one concept, all against graph.json | | Rationale + doc refs | # NOTE: / # WHY: comments and ADR/RFC citations become first-class nodes linked to the code | | Beyond code | Docs, PDFs, images, and video/audio all map into the same graph | | Local-first | Code is parsed locally with tree-sitter (no LLM, nothing leaves your machine); only the semantic pass over docs/media calls a backend, and only if you configure one |

---

Benchmarks

| Benchmark | Metric | graphify | Field | |---|---|---|---| | LOCOMO (n=300) | recall@10 | 0.497 | mem0 0.048, supermemory 0.149 | | LOCOMO (n=300) | QA accuracy | 45.3% | supermemory 49.7%, mem0 27.3% | | LongMemEval-S (n=50) | QA accuracy | 76% | tied with dense RAG | | Graph build | LLM credits | 0 | per-token for most systems |

Every system ran on the same harness with the same model and budgets, scored by a judge blind-validated against a second judge (90.6% agreement, Cohen's kappa 0.81). Full per-system tables, the code-intelligence result, and reproduction commands: BENCHMARKS.md.

---

Prerequisites

| Requirement | Minimum | Check | Install | |---|---|---|---| | Python | 3.10+ | python --version | python.org | | uv (recommended) | any | uv --version | curl -LsSf https://astral.sh/uv/install.sh \| sh | | pipx (alternative) | any | pipx --version | pip install pipx |

macOS quick install (Homebrew):

brew install python@3.12 uv

Windows quick install:

winget install astral-sh.uv

Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# or install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh

---

Install

Official package: The PyPI package is graphifyy (double-y). Other graphify packages on PyPI are not affiliated. The CLI command is still graphify.

Step 1 — install the package:

# Recommended (isolated env; if 'graphify' isn't found after, run: uv tool update-shell):
uv tool install graphifyy

# Alternatives:
pipx install graphifyy
pip install graphifyy  # may need PATH setup — see note below

Step 2 — register the skill with your AI assistant:

graphify install

That's it. Open your AI assistant and type /graphify .

To install the assistant skill into the current repository instead of your user profile, add --project:

graphify install --project
graphify install --project --platform codex

Project-scoped installs write under the current directory, for example .claude/skills/graphify/SKILL.md or .agents/skills/graphify/SKILL.md (plus a references/ sidecar the skill loads on demand), and print a git add hint for files that can be committed. Per-platform commands that support project-scoped installs accept the same flag, for example graphify claude install --project or graphify codex install --project.

PowerShell note: Use graphify . not /graphify . — the leading slash is a path separator in PowerShell.
graphify: command not found? uv tool install / pipx install put the graphify command in their tool bin dir (/.local/bin). If your shell can't find it right after install — common on a f

上游文档较长,此处为节选。完整内容见官方项目。