
DocLayout-YOLO
专为文档版面打造的轻量检测模型,快速框出标题表格图片
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-03 · 当前星标 ★ 2303
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 conda 或 Miniconda
- Python 3.10(由 conda 环境创建)
- pip 包管理工具
- 源码安装方式需要本机具备 git 客户端
安装与启动步骤
-
1创建 Python 环境
用 conda 新建名为 doclayout_yolo 的独立环境,Python 版本按 README 指定为 3.10。
conda create -n doclayout_yolo python=3.10 -
2激活环境
后续所有安装和运行都要在该环境中执行,重新打开终端时需再次激活。
conda activate doclayout_yolo -
3获取项目源码
README 的 pip install -e . 需要在项目根目录执行,因此先把仓库克隆到本地。
git clone https://github.com/opendatalab/DocLayout-YOLO.git cd DocLayout-YOLO -
4源码方式安装
在仓库根目录执行可编辑安装,适合需要改代码、跑训练或评测的场景。
pip install -e . -
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 版面分析模块
下一篇:没有了!
同类项目推荐
ANTs
开源
医学图像精准配准与分割,助力神经影像分析
Advanced Normalization Tools (ANTs)
Anomagic
开源
用文字描述就能生成工业异常图像,零样本搞定缺陷数据增强
[AAAI 2026] The Official Implementation for "Anomagic: Crossmodal Prompt-driven Zero···
pyxu
开源
模块化计算成像框架,轻松实现GPU加速与大规模数据处理
Modular and scalable computational imaging in Python with GPU/out-of-core computing.
prettymaps
开源
输入地名,一键生成艺术感地图海报
Draw pretty maps from OpenStreetMap data! Built with osmnx +matplotlib + shapely
annolid
开源
拖拽标注视频,自动追踪动物并分析行为
An annotation and instance segmentation-based multi-object tracking and behavior ana···
DocLayout-YOLO
开源
专为文档版面打造的轻量检测模型,快速框出标题表格图片
DocLayout-YOLO: Enhancing Document Layout Analysis through Diverse Synthetic Data an···
几行命令跑通 YOLOv7 检测加 SORT 跟踪,视频里目标自动带 ID
YOLOv7 Object Tracking Using PyTorch, OpenCV and Sort Tracking
VSLAM-LAB
开源
一条命令跑通多种 VSLAM 算法与数据集对比
A Comprehensive Framework for Visual SLAM Systems and Datasets
Medical-SAM3
开源
给个提示就能分割任意医学影像,一个模型通吃多模态
Medical SAM3: A Foundation Model for Universal Prompt-Driven Medical Image Segmentat···