Hyper-Extract 是什么?

Hyper-Extract 是 Python 知识提取框架和 CLI,把文本或文档转成强类型的列表、模型、知识图谱、超图、时空图等 Knowledge Abstract,并支持查询、可视化、Obsidian 导出和只读 MCP 接口。

⭐ 2,991 Stars 🍴 349 Forks Python NOASSERTION 作者: yifanfeng97
来源:github.com/yifanfeng97/Hyper-Extract 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目把多种知识结构、提取方法和领域 YAML 模板放在同一工作流里。旧页面的 v0.2.0、Python 环境和 provider 信息已经过期;当前 release 是 v0.10.3,要求 Python 3.11+,并加入 Claude、DeepSeek、本地 vLLM、Obsidian 与 MCP 路径。

来源:github.com/yifanfeng97/Hyper-Extract (1) · github.com/yifanfeng97/Hyper-Extract/releases/tag/v0.10.3 (2)

核心功能

八类强类型知识结构

从 List、Set、Pydantic Model 到 Graph、Hypergraph、Temporal、Spatial 和 Spatio-Temporal Graph。

来源:github.com/yifanfeng97/Hyper-Extract
CLI、模板和增量演化

用 he parse 选择 YAML 模板提取,用 he search/he show 查询与可视化,并向已有 Knowledge Abstract 添加新文档。

来源:github.com/yifanfeng97/Hyper-Extract/blob/main/docs/zh/cli/index.md
多 provider、本地模型与 MCP

支持 OpenAI、Anthropic、DeepSeek、百炼与本地 vLLM;he-mcp 暴露读取、查询和导出工具。

来源:github.com/yifanfeng97/Hyper-Extract

技术架构

三层结构由 Auto-Types、Methods 和 Templates 组成:类型层定义输出结构,方法层选择 GraphRAG、LightRAG、Hyper-RAG 等提取算法,模板层固定领域字段、标识和合并规则。CLI 或 Python API 负责读取、分块、调用结构化输出模型、合并并持久化 Knowledge Abstract。

来源:github.com/yifanfeng97/Hyper-Extract/blob/main/docs/zh/concepts/archi…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Python >=3.11 具备 json_schema 或 function calling 的 LLM具备 json_sche… 语义搜索所需的 OpenAI-compatible embedding endpoint语义搜索所需的 O… 八类强类型知识结构 CLI、模板和增量演化 多 provider、本地模型与 MCP多 provider、本地模… Hyper-Extract 项目本体 核心功能 关键依赖

技术栈

语言Python框架Typer CLI + Pydantic 强类型结构
Python >=3.11具备 json_schema 或 function calling 的 …语义搜索所需的 OpenAI-compatible embedding …
可使用云 provider,也可用本地 vLLM;MCP 额外安装 hyperextract[mcp]
来源:github.com/yifanfeng97/Hyper-Extract/blob/main/pyproject.toml

快速上手

使用 uv tool install hyperextract 或 pipx install hyperextract;通过 he config 选择 LLM 和 embedder;先对公开的 Markdown 示例运行 he parse,再用 he search 与 he show 检查实体、关系和查询结果。
来源:github.com/yifanfeng97/Hyper-Extract

使用场景

适合从论文、财报、政策或内部文档提取固定结构,构建可查询知识图谱,或将结果导出为 Obsidian vault。涉及敏感资料时应选本地模型或经过批准的 provider,并检查输出中的遗漏与虚构关系。

来源:github.com/yifanfeng97/Hyper-Extract

优势与局限

优势

  • 输出结构和字段由模板约束,便于复核
  • 同时支持图、超图、时空图和领域模板
  • CLI、Python、Obsidian 和只读 MCP 路径齐全

局限

  • 依赖模型结构化输出,错误实体和关系仍需回到原文核对
  • Anthropic 与 DeepSeek 没有对应 embedding API,需要另配 embedder
  • 云 provider 会接触输入文档,本地 vLLM 则增加 GPU 和运维成本
来源:github.com/yifanfeng97/Hyper-Extract

最新版本

GitHub 最新正式 release 为 v0.10.3(Working Cypher Export),发布于 2026-09-20;pyproject.toml 版本同为 0.10.3。

来源:github.com/yifanfeng97/Hyper-Extract/releases/tag/v0.10.3

实测与证据

status: official_docs_checked_not_locally_installed  |  checked_at: 2026-09-23  |  environment: 核对官方 README、中文 CLI/架构文档、pyproject.toml 和 v0.10.3 release;未安装 CLI 或调用模型  |  limitations: 未验证文档解析、抽取准确率、费用、本地 vLLM、Obsidian 导出或 MCP 客户端  |  observed_output: 官方资料确认 Python >=3.11、uv/pipx 安装、he config/parse/search/show/export、provider 配置、MCP extra 与 v0.10.3

来源:github.com/yifanfeng97/Hyper-Extract

同类项目对比

Microsoft GraphRAG 重点是从文本建立实体/关系与社区摘要,再做全局或局部检索;Hyper-Extract 还提供多种强类型输出、超图/时空图、80+ YAML 模板、Obsidian 导出和 CLI。需要标准 GraphRAG 索引与查询研究时先看 GraphRAG;需要按领域模板直接得到不同知识结构时看 Hyper-Extract。

来源:github.com/yifanfeng97/Hyper-Extract (1) · github.com/microsoft/graphrag (2)

总结评价

适合需要用模板约束实体、关系或时空结构,并希望通过 CLI、Python、Obsidian 或 MCP 使用结果的团队。先用公开小文档验证模板和 provider,再评估准确率、费用、隐私和人工复核成本。

来源:官方 Releases

常见问题

Hyper-Extract 当前需要哪个 Python 版本?

v0.10.3 的 pyproject.toml 要求 Python 3.11 或更新版本。

使用 DeepSeek 或 Claude 时还需要 embedding 模型吗?

需要语义搜索时需要。官方说明 DeepSeek 和 Anthropic 没有 embedding API,要另配 OpenAI-compatible embedder。

Hyper-Extract 输出的实体和关系可以直接当事实吗?

不能。模板约束输出结构,但内容仍由模型提取,必须回到原文核对遗漏、合并错误和虚构关系。

Hyper-Extract 与 Microsoft GraphRAG 怎么选?

需要标准 GraphRAG 索引和全局/局部查询时先看 GraphRAG;需要多种强类型结构和领域模板时看 Hyper-Extract。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 10:52.

参考材料:README、GitHub API、依赖文件