code-graph-rag

用知识图谱让AI读懂你的大型代码库,查询、理解、改代码更精准

code-graph-rag 是一个面向大型代码仓库(monorepo)的检索增强生成(RAG)系统,旨在解决传统 RAG 在代码理解上的不足。它通过构建代码知识图谱,将代码中的函数、类、调用关系等结构化信息整合,使得 AI 能够更准确地理解多语言代码库的上下文。用户可以用自然语言查询代码、理解模块依赖,甚至辅助代码编辑。核心能力包括:基于知识图谱的语义检索、跨文件/跨语言的代码关联分析、以及与 AI 模型结合的问答和代码生成。它特别适合处理复杂工程,能显著提升代码检索和理解的准确性,减少开发者在大型代码库中的导航和认知负担。

开源 free 搜索知识
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 5168
维护状态 活跃
是否开源
定价模式 free

项目数据

分类搜索知识
开发团队vitali87
所属国家
定价模式free
价格说明开源项目,MIT许可证,可自行部署使用,无付费版本。
访问状态
是否开源
开源协议MIT
主要语言Python
技术栈/模型ai,ast,claude-code,code-analysis,code-understanding,codebase-search,developer-tools,graph-database,knowledge-graph,llm,mcp,mcp-server,memgraph,monorepo,multi-language,python,rag,retrieval-augmented-generation,semantic-search,tree-sitter
GitHub 星标★ 5168
30天Star增速
HF 下载量
上线时间2025-06-16 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数1

使用教程

难度:进阶 约 15 分钟 部署方式:命令行工具 4 步

环境要求

  • Python 环境(cgr 是发布在 PyPI 上的 Python 包)
  • 可访问 PyPI 的网络环境
  • 一个运行中的 Memgraph 图数据库实例
  • 安装时需要 treesitter-full 与 semantic 两个扩展对应的依赖

安装与启动步骤

  1. 1检查 Python 环境

    确认本机已装好 Python 与 pip,能进行系统级包安装。README 未给出具体版本要求,用通用命令确认即可。

    python --version
  2. 2安装 cgr 命令行

    从 PyPI 安装 code-graph-rag,并带上 treesitter-full(全部语言)和 semantic(向量检索)扩展。

    pip install "code-graph-rag[treesitter-full,semantic]"
  3. 3准备 Memgraph

    项目把代码知识图谱构建在 Memgraph 中,需要先有一个可连接的 Memgraph 实例。README 未给出启动命令,请按 Memgraph 官方文档部署。

  4. 4验证安装

    执行 cgr 确认命令行入口已可用,之后即可对代码仓库建图并用自然语言查询、编辑代码。

    cgr

如何确认成功

执行 cgr 无报错(能打印帮助或进入交互),且能连接上 Memgraph,即说明安装可用。

常见问题

Q:为什么安装时要带 [treesitter-full,semantic]?

A:README 说明前者提供全部语言的解析支持,后者提供向量检索(语义搜索)能力;不安装会缺少多语言解析或语义检索。

Q:必须自己部署 Memgraph 吗?

A:是。README 明确知识图谱构建在 Memgraph 中,需要有一个可连接的 Memgraph 实例,具体启动方式请参考 Memgraph 官方文档。

Q:cgr 和 code-graph-rag 是同一个东西吗?

A:是。PyPI 包名为 code-graph-rag,安装后提供的命令行入口是 cgr,用于建图和自然语言查询。

Q:README 里的安装命令没显示完整怎么办?

A:节选中的命令被截断了,可对照 PyPI 项目页或官网 code-graph-rag.com 的安装章节确认完整写法。

注意事项

  • README 节选中的安装命令未完整展示,请以官方文档或 PyPI 页面为准。
  • 项目用 Tree-sitter 解析多语言 monorepo,并统一写入同一套图 schema。
  • 查询、编辑和优化代码都通过自然语言完成,底层依赖 LLM 能力。

核心亮点

  • 知识图谱建模代码结构,检索结果比纯向量更精准
  • 支持多语言,适合大型 monorepo 的跨文件查询
  • 提供交互式查询和编辑辅助,提升开发效率

不足之处

  • 知识图谱构建有额外计算开销,小项目可能不划算
  • 文档/社区待观察

适用场景

  • 大型 monorepo 中快速定位函数实现或调用链
  • 新成员通过自然语言了解代码库架构
  • AI 辅助重构时理解跨模块影响

替代项目

GraphRAG、LlamaIndex、LangChain

项目介绍

code-graph-rag 是搜索知识领域的开源项目,由 vitali87 开发,2025 年首次发布。

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

近 41 天,它的 GitHub 星标从 4,087 增加到 5,168,净增 1,081。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。MIT许可证,可自行部署使用,无付费版本。

它主要面向的使用场景是:大型monorepo中快速定位函数实现或调用链。同类可对比的替代方案包括 GraphRAG、LlamaIndex、LangChain。

上一篇:trieve

下一篇:Awesome-GraphRAG

同类项目推荐

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
ragflow 开源

让大模型用上你的私有知识,搭建可靠的企业级RAG应用

RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fu···

★ 91170 2026-08-09