跳转到主要内容

文档 1.5 版本已不再积极维护,你当前浏览的是一份归档快照。 最新文档请参阅 最新版本。

HugeGraph-AI

Apache License 2.0 Ask DeepWiki

hugegraph-ai 整合了 HugeGraph 与人工智能功能,为开发者构建 AI 驱动的图应用提供全面支持。

✨ 核心功能

  • GraphRAG:利用图增强检索构建智能问答系统
  • 知识图谱构建:使用大语言模型从文本自动构建图谱
  • 图机器学习:集成 20 多种图学习算法(GCN、GAT、GraphSAGE 等)
  • Python 客户端:易于使用的 HugeGraph Python 操作接口
  • AI 智能体:提供智能图分析与推理能力

🚀 快速开始

说明

如需完整的部署指南和详细示例,请参阅 hugegraph-llm/README.md。

环境要求

  • Python 3.9+(建议 hugegraph-llm 使用 3.10+)
  • uv(推荐的包管理器)
  • HugeGraph Server 1.3+(建议 1.5+)
  • Docker(可选,用于容器化部署)

方案一:Docker 部署(推荐)

 1# 克隆仓库
 2git clone https://github.com/apache/incubator-hugegraph-ai.git
 3cd incubator-hugegraph-ai
 4
 5# 设置环境并启动服务
 6cp docker/env.template docker/.env
 7# 编辑 docker/.env 设置你的 PROJECT_PATH
 8cd docker
 9docker-compose -f docker-compose-network.yml up -d
10
11# 访问服务:
12# - HugeGraph Server: http://localhost:8080
13# - RAG 服务: http://localhost:8001

方案二:源码安装

 1# 1. 启动 HugeGraph Server
 2docker run -itd --name=server -p 8080:8080 hugegraph/hugegraph
 3
 4# 2. 克隆并设置项目
 5git clone https://github.com/apache/incubator-hugegraph-ai.git
 6cd incubator-hugegraph-ai/hugegraph-llm
 7
 8# 3. 安装依赖
 9uv venv && source .venv/bin/activate
10uv pip install -e .
11
12# 4. 启动演示
13python -m hugegraph_llm.demo.rag_demo.app
14# 访问 http://127.0.0.1:8001

基本用法示例

GraphRAG - 问答

 1from hugegraph_llm.operators.graph_rag_task import RAGPipeline
 2
 3# 初始化 RAG 工作流
 4graph_rag = RAGPipeline()
 5
 6# 对你的图进行提问
 7result = (graph_rag
 8    .extract_keywords(text="给我讲讲 Al Pacino 的故事。")
 9    .keywords_to_vid()
10    .query_graphdb(max_deep=2, max_graph_items=30)
11    .synthesize_answer()
12    .run())

知识图谱构建

 1from hugegraph_llm.models.llms.init_llm import LLMs
 2from hugegraph_llm.operators.kg_construction_task import KgBuilder
 3
 4# 从文本构建知识图谱
 5TEXT = "你的文本内容..."
 6builder = KgBuilder(LLMs().get_chat_llm())
 7
 8(builder
 9    .import_schema(from_hugegraph="hugegraph")
10    .chunk_split(TEXT)
11    .extract_info(extract_type="property_graph")
12    .commit_to_hugegraph()
13    .run())

图机器学习

1from pyhugegraph.client import PyHugeClient
2# 连接 HugeGraph 并运行机器学习算法
3# 详细示例请参阅 hugegraph-ml 文档

📦 模块

hugegraph-llm Ask DeepWiki

用于图应用的大语言模型集成:

  • GraphRAG:基于图数据的检索增强生成
  • 知识图谱构建:从文本自动构建知识图谱
  • 自然语言接口:使用自然语言查询图
  • AI 智能体:智能图分析与推理

hugegraph-ml

包含 20+ 算法的图机器学习:

  • 节点分类:GCN、GAT、GraphSAGE、APPNP 等
  • 图分类:DiffPool、P-GNN 等
  • 图嵌入:DeepWalk、Node2Vec、GRACE 等
  • 链接预测:SEAL、GATNE 等

hugegraph-python-client

用于 HugeGraph 操作的 Python 客户端:

  • Schema 管理:定义顶点/边标签和属性
  • CRUD 操作:创建、读取、更新、删除图数据
  • Gremlin 查询:执行图遍历查询
  • REST API:完整的 HugeGraph REST API 覆盖

📚 了解更多

🔗 相关项目

🤝 贡献

我们欢迎贡献!详情请参阅我们的贡献指南。

开发设置:

  • 使用 GitHub Desktop 更轻松地管理 PR
  • 提交 PR 前运行 ./style/code_format_and_analysis.sh
  • 报告错误前检查现有问题

View the HugeGraph-AI contributors.

📄 许可证

hugegraph-ai 采用 Apache 2.0 许可证。

📞 联系我们

Apache HugeGraph 微信公众号二维码{width=“200” height=“63”}