DocLayout-YOLO

专为文档版面打造的轻量检测模型,快速框出标题表格图片

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 计算机视觉 🍴 复刻 179 🐛 待处理 56 👀 关注 9
GitHub ↗
GitHub 星标 ★ 2303
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,遵循AGPL-3.0许可证

项目预览

DocLayout-YOLO 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类计算机视觉
开发团队opendatalab
定价模式🏷️完全免费
价格说明开源免费,遵循AGPL-3.0许可证
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议AGPL-3.0
主要语言Python
GitHub 星标★ 2303
上线时间2024-10-14 00:00:00
代码更新2026-10-21
仓库体积12.5 MB
本站数据更新2026-11-03
维护状态较活跃
收录时间2026-11-03
浏览次数0

项目介绍

DocLayout-YOLO 是面向文档版面分析的目标检测模型,在 YOLO 框架上针对文档图像做专项优化。它要解决的问题是:合同、论文、报表等扫描件中的标题、正文、表格、图片、页眉页脚等区域需要被自动定位和分类,传统通用检测器在小目标、密集排版和跨版式泛化上表现不稳。项目核心能力有三点:一是通过多样化合成数据增强训练样本,覆盖不同版式与字体排布,提升模型对真实文档的适应力;二是提出全局到局部的自适应感知结构,兼顾整页版面上下文与局部细粒度区域;三是提供完整的训练、推理与评测流程,可直接输出版面元素框与类别,便于下游做文档解析、OCR 区域切分和结构化抽取。项目以 Python 实现,模型轻量、推理速度快,适合集成进文档处理流水线。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-03 · 当前星标 ★ 2303

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:库/依赖 5 步

环境要求

  • 已安装 conda 或 Miniconda
  • Python 3.10(由 conda 环境创建)
  • pip 包管理工具
  • 源码安装方式需要本机具备 git 客户端

安装与启动步骤

  1. 1创建 Python 环境

    用 conda 新建名为 doclayout_yolo 的独立环境,Python 版本按 README 指定为 3.10。

    conda create -n doclayout_yolo python=3.10
  2. 2激活环境

    后续所有安装和运行都要在该环境中执行,重新打开终端时需再次激活。

    conda activate doclayout_yolo
  3. 3获取项目源码

    README 的 pip install -e . 需要在项目根目录执行,因此先把仓库克隆到本地。

    git clone https://github.com/opendatalab/DocLayout-YOLO.git
    cd DocLayout-YOLO
  4. 4源码方式安装

    在仓库根目录执行可编辑安装,适合需要改代码、跑训练或评测的场景。

    pip install -e .
  5. 5仅推理的安装方式

    如果只调用模型做推理,README 说明可直接用 pip 安装发布包,无需源码。

    pip install doclayout-yolo

如何确认成功

在已激活的环境中执行 pip show doclayout-yolo,能显示包名与版本信息即表示安装成功。

常见问题

Q:两种安装方式该选哪个?

A:需要修改代码、训练或评测时用 pip install -e . 源码安装;只做推理时直接 pip install doclayout-yolo 更省事。

Q:必须用 Python 3.10 吗?

A:README 的示例命令固定使用 python=3.10,建议保持一致,避免依赖版本不匹配。

Q:需要 GPU 吗?

A:README 节选未说明硬件要求,项目为 PyTorch 实现,可按实际机器情况选择 CPU 或对应 CUDA 版本的 PyTorch。

Q:重开终端后命令找不到怎么办?

A:说明 conda 环境未激活,重新执行 conda activate doclayout_yolo 再运行。

注意事项

  • README 节选只覆盖环境安装,推理与训练的具体命令请以仓库后续文档为准,不要自行臆测参数。
  • 官方提供在线 Demo,可先在线体验效果再决定是否本地部署。
  • 项目还发布了 DocSynth-300K 合成数据集与 Mesh-candidate Bestfit 合成流程,需要预训练数据时可在仓库内文档查看。

核心亮点

  • 针对文档场景设计全局到局部自适应感知,小目标与密集排版区域检测更稳
  • 用多样化合成数据扩充训练集,缓解真实标注文档稀缺、版式覆盖不足的问题
  • 基于 YOLO 架构,模型轻量、推理速度快,便于嵌入文档解析流水线

不足之处

  • 合成数据与真实扫描件之间仍存在域差异,极端版式或低质量扫描下效果需自行验证
  • 主要覆盖常见版面元素类别,垂直领域文档(如票据、表单)需重新标注微调

适用场景

  • 扫描合同与公文的结构化解析,先定位标题、正文、表格区域再送 OCR
  • 学术论文 PDF 转结构化数据,切分章节、图表与参考文献区块
  • 企业报表与发票批量处理,自动识别表格和关键字段所在区域

替代项目

LayoutLMv3、DiT (Document Image Transformer)、PaddleOCR 版面分析模块

上一篇:qinglong-captions

下一篇:没有了!

同类项目推荐

ANTs 开源

医学图像精准配准与分割,助力神经影像分析

Advanced Normalization Tools (ANTs)

★ 1512 2026-08-10
Anomagic 开源

用文字描述就能生成工业异常图像,零样本搞定缺陷数据增强

[AAAI 2026] The Official Implementation for "Anomagic: Crossmodal Prompt-driven Zero···

★ 161 2026-08-09
pyxu 开源

模块化计算成像框架,轻松实现GPU加速与大规模数据处理

Modular and scalable computational imaging in Python with GPU/out-of-core computing.

★ 142 2026-08-09
prettymaps 开源

输入地名,一键生成艺术感地图海报

Draw pretty maps from OpenStreetMap data! Built with osmnx +matplotlib + shapely

★ 14319 2026-08-09
annolid 开源

拖拽标注视频,自动追踪动物并分析行为

An annotation and instance segmentation-based multi-object tracking and behavior ana···

★ 59 2026-08-09
DocLayout-YOLO 开源

专为文档版面打造的轻量检测模型,快速框出标题表格图片

DocLayout-YOLO: Enhancing Document Layout Analysis through Diverse Synthetic Data an···

★ 2303 2026-11-03
yolov7-object-tracking 开源

几行命令跑通 YOLOv7 检测加 SORT 跟踪,视频里目标自动带 ID

YOLOv7 Object Tracking Using PyTorch, OpenCV and Sort Tracking

★ 653 2026-09-13
VSLAM-LAB 开源

一条命令跑通多种 VSLAM 算法与数据集对比

A Comprehensive Framework for Visual SLAM Systems and Datasets

★ 569 2026-09-21
Medical-SAM3 开源

给个提示就能分割任意医学影像,一个模型通吃多模态

Medical SAM3: A Foundation Model for Universal Prompt-Driven Medical Image Segmentat···

★ 235 2026-10-01