code-graph-rag

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 713 🐛 待处理 476 👀 关注 34
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 5346
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,可自行部署使用,无付费版本。

项目预览

code-graph-rag 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队vitali87
定价模式🏷️完全免费
价格说明开源项目,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 星标★ 5346
上线时间2025-06-16 00:00:00
代码更新2026-11-09
仓库体积588.2 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数2

项目介绍

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

Star 增长趋势

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

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

使用教程

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

难度:进阶 约 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

上一篇:trieve

下一篇:Awesome-GraphRAG

同类项目推荐

hyde 开源

让LLM生成假设文档,零样本提升检索精度

HyDE: Precise Zero-Shot Dense Retrieval without Relevance Labels

★ 582 2026-08-09
warc-gpt 开源

把历史网页变成可问答的知识库

WARC + AI - Experimental Retrieval Augmented Generation Pipeline for Web Archive Col···

★ 281 2026-08-09
bkmr 开源

本地优先的语义书签管理,让人类和 AI 代理都能快速检索知识。

Knowledge Management for Humans and Agents

★ 268 2026-08-09
nucliadb 开源

把任意数据变成可搜索的 AI 知识库,快速搭建 RAG 应用。

NucliaDB, The AI Search database for RAG

★ 721 2026-08-09
SwiftSemanticSearch 开源

在 Apple 设备上实时用摄像头或文字搜索图像,全本地运行

Real-time on-device text-to-image and image-to-image Semantic Search with video stre···

★ 162 2026-08-09
ai-second-brain 开源

把散落的 AI 对话整理成可检索的个人知识库

Build a living, searchable AI second brain from your ChatGPT, Claude, and research h···

★ 226 2026-11-07
RAG-SaaS 开源

快速搭建 RAG 应用,从想法到上线一步到位

⚡Ship RAG Solutions Quickly and effortlessly

★ 192 2026-08-09