Hyperbase

语义超图的基础库

Hyperbase 是一个用于处理 语义超图 (SH) 的基础库，它使得我们可以将诸如“爱因斯坦于1905年首次发表了相对论”这样的自然语言句子表示为一种有序的、递归的超链接结构，形式如下：

{ width="75%" }

Hyperbase 使用 Python 编写，既充分利用了该语言中丰富的科学类库生态，也便于与其他工具进行集成。它采用非常宽松的 MIT 开源许可证发布。

安装与手册

安装说明、用户手册及更多信息请参见：https://hyperquest.ai/hyperbase

贡献

欢迎提交 Pull Request。对于重大更改，请先开 Issue 讨论您计划修改的内容。

请确保相应地更新测试用例。

资助

本软件库的开发及其背后的相关研究工作得到了法国国家科学研究中心（CNRS）以及欧洲研究理事会整合型项目资助 Socsemics（资助编号 #772743）的支持。

许可证

MIT

Hyperbase 快速上手指南

Hyperbase 是一个用于处理**语义超图（Semantic Hypergraphs, SH）**的基础 Python 库。它能够将自然语言句子（如“爱因斯坦于 1905 年首次发表了相对论”）表示为有序的、递归的超链接结构，非常适合需要深度语义分析和知识图谱构建的场景。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、macOS 或 Windows
• Python 版本：推荐 Python 3.8 及以上版本
• 前置依赖：
  • pip (Python 包管理工具)
  • 建议创建虚拟环境以避免依赖冲突：

    python -m venv hyperbase-env
    source hyperbase-env/bin/activate  # Linux/macOS
    # 或
    hyperbase-env\Scripts\activate     # Windows
    

安装步骤

由于官方文档指向特定站点，建议优先尝试从 PyPI 安装。国内开发者可使用清华源或阿里源加速下载。

方式一：使用 pip 安装（推荐）

pip install hyperbase -i https://pypi.tuna.tsinghua.edu.cn/simple

方式二：从源码安装（如需最新特性）

如果 PyPI 版本未更新，可从 GitHub 克隆并安装：

git clone https://github.com/hyperquest/hyperbase.git
cd hyperbase
pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple

注意：详细的手册和高级配置请访问官方文档：https://hyperquest.ai/hyperbase

基本使用

Hyperbase 的核心功能是将自然语言文本转换为语义超图结构。以下是最简单的使用示例：

from hyperbase import Hypergraph

# 初始化超图对象
hg = Hypergraph()

# 定义一个自然语言句子
sentence = "Einstein first published the theory of relativity in 1905"

# 将句子解析并添加为语义超边（具体解析器需根据实际版本 API 调整）
# 此处展示核心概念：将文本转化为递归超链接结构
edge_id = hg.add_sentence(sentence)

# 访问生成的超图结构
print(f"Added edge: {edge_id}")
print(hg.structure())

注：由于 Hyperbase 处于基础库阶段，具体的解析器接口（Parser API）可能随版本迭代有所变化。请参照官方手册中关于 add_sentence 或对应 NLP 后端的具体调用方式。

---

许可证：本项目基于 MIT 协议开源，可自由用于商业和非商业用途。