项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5301
使用教程
环境要求
- Python 3.12 或更高版本(本地/独立部署后端时需要)
- Neo4j 数据库 5.23 或更高版本,并安装 APOC 插件
- Node.js 与 yarn(前端独立运行需要)
- 一个可用的 LLM API Key(Docker 部署默认启用 OpenAI 与 Diffbot)
安装与启动步骤
-
1准备前置环境
先安装 Python 3.12+、Node.js/yarn;准备 Neo4j 5.23+ 实例并安装 APOC。Neo4j Aura 含免费版都可用。
-
2克隆项目代码
把仓库拉到本地,后续所有命令都在项目根目录下执行。
git clone https://github.com/neo4j-labs/llm-graph-builder.git cd llm-graph-builder -
3配置后端环境变量
复制示例环境文件生成 backend/.env,然后填入你的 Neo4j 连接信息,可跳过登录弹窗。
cp backend/example.env backend/.env -
4安装后端依赖
在 backend 目录建虚拟环境并安装 requirements.txt。Windows 激活命令为 venv\Scripts\activate。
cd backend python3.12 -m venv venv source venv/bin/activate pip install -r requirements.txt -
5启动后端服务
在已激活虚拟环境的 backend 目录启动 uvicorn,--reload 用于开发热重载。
uvicorn score:app --reload -
6配置并装前端依赖
复制前端示例环境文件生成 frontend/.env,按需修改变量后用 yarn 安装依赖。
cd frontend cp frontend/example.env frontend/.env yarn -
7启动前端服务
在 frontend 目录运行开发服务器,终端会输出本地访问地址,浏览器打开即可。
cd frontend yarn run dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
NEO4J_URI | 是 | Neo4j 数据库连接地址(Aura 或自建实例) | neo4j+s://xxxx.databases.neo4j.io |
NEO4J_USERNAME | 是 | Neo4j 登录用户名 | neo4j |
NEO4J_PASSWORD | 是 | Neo4j 登录密码 | your-password |
NEO4J_DATABASE | 是 | 要写入的 Neo4j 数据库名 | neo4j |
OPENAI_API_KEY | 是 | 调用 OpenAI 模型生成图谱所需的密钥 | sk-xxxxxxxx |
TRACK_USER_USAGE | 否 | 设为 true 开启按用户/库统计 Token 用量 | false |
如何确认成功
后端 uvicorn 启动无报错,前端 yarn run dev 输出本地地址,浏览器打开能看到 Neo4j 连接登录界面即成功。
常见问题
Q:为什么必须用 Neo4j 5.23 及以上?
A:后端使用了 Cypher 变量作用域子查询语法 CALL (variable) { ... },5.20 等更早的 5.x 版本不支持该语法,会直接报错。
Q:用 Neo4j Desktop 可以跑 docker-compose 吗?
A:不支持。使用 Neo4j Desktop 时需要按文档分别部署后端和前端,不能直接用 docker-compose 一键启动。
Q:默认支持哪些 LLM 和输入源?
A:默认只启用 OpenAI 和 Diffbot(Gemini 需额外 GCP 配置);输入源默认是 local、YouTube、Wikipedia、AWS S3 和 web。
Q:前端能切换 embedding 模型吗?
A:取决于 TRACK_USER_USAGE:设为 true 可在前端选择并保存;设为 false 时只能通过 .env 的 EMBEDDING_MODEL/EMBEDDING_PROVIDER 指定,前端不可改。
注意事项
- Neo4j 必须安装 APOC 插件,否则图谱写入相关功能可能失败。
- 未设置 EMBEDDING_MODEL 和 EMBEDDING_PROVIDER 时,应用默认使用 Sentence Transformer 模型。
- GCS 数据源默认未开启,需要额外配置 gcs 与 Google Client ID。
- 若不想用 Docker,可在 GCP 上用 gcloud run deploy 分别部署前后端到 Cloud Run。
核心亮点
- 自动抽取实体关系,省去人工建模时间
- 提供可视化界面,支持手动修正图谱结果
- 支持多种数据源(文本、PDF、网页)导入
不足之处
- 依赖LLM API,处理大规模数据时成本较高
- 文档/社区待观察
适用场景
- 企业内部文档知识库结构化
- 学术论文与研究报告的关系提取
- 快速搭建领域知识图谱原型
替代项目
LangChain、Haystack、txtai
同类项目推荐
casbin-gateway
开源
给 AI 和 MCP 服务加一道安全闸门,防攻击、控权限。
See what every AI coding agent on your machine is doing, and whether the API behind ···
chatllm.cpp
开源
纯 C++ 本地跑大模型,开箱即聊不装 Python
Pure C++ implementation of several models for real-time chatting on your computer (C···
Awesome-LLMOps
开源
一站式找到大模型开发运维工具,告别选型困难
An awesome & curated list of best LLMOps tools for developers
clearml
开源
一站式 MLOps 平台,从实验到部署全自动
ClearML - Auto-Magical CI/CD to streamline your AI workload. Experiment Management, ···
podman-desktop-extension-ai-lab
开源
在桌面点点鼠标,用容器在本机跑起大模型
Work with LLMs on a local environment using containers
agentsecrets
开源
让 AI 代理安全使用凭证,无需泄露秘密
Zero-knowledge credentials infrastructure built for AI agents to operate, not just c···
ijfw
开源
让多个 AI 编程代理协同工作,自动记忆、路由和互审,代码质量稳了。
IJFW — It Just F*cking Works. Ferrox Labs' local-first infrastructure for AI coding···
gateway
开源
一个 API 接入 1600+ 模型,内置安全护栏,AI 应用开发提速。
A blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI G···
weightslab
开源
让 AI 工程师轻松搞定图像、视频、点云等杂乱数据
Monitoring platform for ML teams building real‑world AI at scale.
