开源文档解析工具,将 PDF、Office 文档和图片转换为 Markdown 或 JSON,供大模型和智能体使用。
SoMarkAI/OXR
开源文档解析模型,将 PDF 和文档图片转换为带布局坐标的 Markdown 或 JSON,便于 Agent 使用。
- Star
- 3,668
- Fork
- 240
- 未关闭 Issue
- 3
- 最近提交
- 昨天
这是什么?
OXR(Optical Everything Recognition)是 SoMark 团队开源的文档解析模型,参数量为 1.3B。它接收 PDF 和文档图片,输出带布局坐标的 Markdown 或 JSON,方便下游的 AI Agent 与检索流程直接使用。
模型可识别 13 类文档元素,包括以 LaTeX 输出的公式、以 HTML 或 Markdown 输出的表格、化学方程式与结构式、代码块和印章等。阅读顺序由同一模型在识别阶段一并处理。版面分析则是独立可插拔的模块,团队可以替换为自己的版面模型,同时保留 OXR 的识别和排序能力。
项目提供 Docker 镜像和源码部署两种方式,源码部署支持 vLLM 推理,并自带端口 8000 的可视化演示页面。此外还有与 SoMark API 兼容的免费托管接口,可配合其 Python 和 JavaScript 命令行工具使用。本地部署需要支持 BF16 的 NVIDIA GPU,单卡 24GB 显存可以起步。
核心功能
- 01将 PDF 和图片解析为带布局坐标的 Markdown 或 JSON。
- 02可识别公式、表格、化学结构式、代码块等 13 类元素。
- 03阅读顺序与内容识别由同一模型完成。
- 04版面分析为独立模块,可替换为自定义模型。
- 05提供 Docker 部署、基于 vLLM 的源码部署以及可视化演示页面。
- 06API 兼容 SoMark 的命令行工具与 SDK。
适用场景
- 将扫描的试卷、论文或报告转换为结构化文本,供 LLM 或 RAG 流程使用。
- 从学术文档中提取复杂表格和公式。
- 在特定文档领域替换版面分析模块,同时复用 OXR 的识别能力。
快速上手
- 1
从 PyPI 安装 somark 命令行工具
pip install somark - 2
使用免费 OXR API 解析文档(无需 API 密钥)
somark --base-url https://free-oxr.somark.ai/api/v1 --api-key dummy parse document.pdf --formats md,json --out ./parsed-output/
使用前须知
- 本地运行需要 Linux 系统和 NVIDIA GPU,且至少 24GB 显存。
- 免费 API 不保证服务稳定性,不建议用于生产环境。
- README 未明确说明软件许可证,商用前请先查看仓库。
收录于专题
标签
常见问题
- OXR 是什么?
- 开源文档解析模型,将 PDF 和文档图片转换为带布局坐标的 Markdown 或 JSON,便于 Agent 使用。 OXR(Optical Everything Recognition)是 SoMark 团队开源的文档解析模型,参数量为 1.3B。它接收 PDF 和文档图片,输出带布局坐标的 Markdown 或 JSON,方便下游的 AI Agent 与检索流程直接使用。
- OXR 可以免费使用吗?用的什么许可证?
- OXR 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
- OXR 还在维护吗?
- 活跃维护中。OXR 最近一次提交是在 2026年11月6日。
- OXR 适合用来做什么?
- 将扫描的试卷、论文或报告转换为结构化文本,供 LLM 或 RAG 流程使用。 从学术文档中提取复杂表格和公式。 在特定文档领域替换版面分析模块,同时复用 OXR 的识别能力。
- OXR 怎么安装和运行?
- 从 PyPI 安装 somark 命令行工具: pip install somark 使用免费 OXR API 解析文档(无需 API 密钥): somark --base-url https://free-oxr.somark.ai/api/v1 --api-key dummy parse document.pdf --formats md,json --out ./parsed-output/
- 在哪里获取 OXR?
- 源代码和安装说明在 GitHub 上:https://github.com/SoMarkAI/OXR
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
可自托管的文档智能 API,将 PDF、Office 文件和图片转换为适合 LLM 使用的分块数据。
开源文档解析工具,把 PDF、Office、HTML 等文件转换为结构化数据,供生成式 AI 使用。
开源 PDF 解析工具,可将 PDF 转为 Markdown、带边界框的 JSON 和 HTML,并为无标签 PDF 自动生成标签。
百度开源的视觉语言 OCR 模型,可一次性解析长篇多页文档与 PDF 并输出结构化文本。
开源 Python 库,把 PDF、HTML、Word、邮件等文档解析为结构化元素,便于用于大模型流程。