Repolode
SoMarkAI

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. 1

    从 PyPI 安装 somark 命令行工具

    pip install somark
  2. 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 数据每日更新。

相关项目