安装¶
OntoMem 的完整安装指南。
系统需求¶
- Python：3.11 或更高版本
- OS：Linux、macOS 或 Windows
- 内存：最少 2GB RAM（大规模部署需要更多）
安装方法¶
方案 1：PyPI（用户推荐）¶
安装最新稳定版本：
pip install ontomem
方案 2：uv（开发者推荐）¶
快速的现代 Python 包管理器：
# 如果还未安装 uv
curl https://astral.sh/uv/install.sh | sh
# 安装 ontomem
uv add ontomem
方案 3：从源代码安装（开发）¶
# 克隆仓库
git clone https://github.com/yifanfeng97/ontomem.git
cd ontomem
# 开发模式安装
uv sync --group dev
# 或使用 pip
pip install -e .
可选依赖¶
用于 LLM 驱动的合并¶
如果想使用基于 LLM 的合并策略：
pip install langchain langchain-openai
用于向量搜索¶
FAISS 包含在基础安装中。对于 GPU 加速：
pip install faiss-gpu # CUDA 启用的 FAISS（需要 NVIDIA GPU）
开发工具¶
为 OntoMem 做贡献：
uv sync --group dev
包括：
- pytest - 测试框架
- mkdocs - 文档生成
- black - 代码格式化
- ruff - 代码检查
验证¶
验证你的安装：
from ontomem import OMem, MergeStrategy
print("✅ OntoMem 安装成功！")
或从命令行：
python -c "import ontomem; print(ontomem.__version__)"
故障排除¶
ImportError: FAISS not found¶
pip install faiss-cpu
对于 GPU 支持（仅 NVIDIA）：
pip install faiss-gpu
LangChain 问题¶
确保你有正确的版本：
pip install "langchain>=1.2.1" "langchain-openai>=1.1.6" "langchain-community>=0.4.1"
Pydantic 版本冲突¶
OntoMem 需要 Pydantic 2.x：
pip install "pydantic>=2.12.5"
环境设置¶
API 密钥¶
如果使用 LLM 功能，设置 OpenAI API 密钥：
export OPENAI_API_KEY="your-api-key-here"
或在 Python 中：
import os
os.environ["OPENAI_API_KEY"] = "your-api-key-here"
虚拟环境（可选但推荐）¶
# 创建虚拟环境
python -m venv .venv
# 激活
source .venv/bin/activate # 在 Windows 上: .venv\Scripts\activate
# 安装 ontomem
pip install ontomem
下一步¶
有问题？ 查看我们的 FAQ 或 GitHub Issues。