安装指南

本文档将指导您如何安装 OCR 评估框架。

系统要求

• Python 3.8 或更高版本

• 操作系统：Windows、macOS 或 Linux

从 PyPI 安装

最简单的安装方式是通过 PyPI：

pip install ocr-evaluation

安装特定版本：

pip install ocr-evaluation==1.0.0

从源码安装

如果您想从源码安装最新版本：

git clone https://github.com/forayl/ocr-evaluation.git
cd ocr-evaluation
pip install -e .

安装可选依赖

安装所有依赖（包括开发工具）：

pip install ocr-evaluation[all]

安装特定引擎支持：

# PaddleOCR 支持
pip install ocr-evaluation[paddleocr]

# Qwen 支持
pip install ocr-evaluation[qwen]

安装开发依赖：

pip install ocr-evaluation[dev]

安装文档生成工具：

pip install ocr-evaluation[docs]

验证安装

安装完成后，您可以通过以下命令验证安装：

ocr-evaluation --version

如果安装成功，您应该看到版本信息。

故障排除

常见问题：

1. 权限错误: 使用 pip install –user 或虚拟环境

2. 依赖冲突: 建议使用虚拟环境

3. 编译错误: 确保安装了开发工具

使用虚拟环境（推荐）：

python -m venv ocr_env
source ocr_env/bin/activate  # Linux/macOS
# 或
ocr_env\Scripts\activate     # Windows
pip install ocr-evaluation