deepdoctection

一行代码搭建文档解析流水线,快速提取版面、表格与文本。

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 计算机视觉 🍴 复刻 203 🐛 待处理 8 👀 关注 23
GitHub ↗
GitHub 星标 ★ 3269
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,Apache-2.0 许可证,可免费使用和部署。

项目预览

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

项目数据

分类计算机视觉
开发团队deepdoctection
定价模式🏷️完全免费
价格说明开源项目,Apache-2.0 许可证,可免费使用和部署。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型document-ai,document-image-analysis,document-layout-analysis,document-parser,document-understanding,layoutlm,nlp,ocr,publaynet,pubtabnet,python,pytorch,table-detection,table-recognition,tensorflow
GitHub 星标★ 3269
上线时间2021-12-09 00:00:00
代码更新2026-10-21
仓库体积35.7 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-10
浏览次数3

项目介绍

deepdoctection 是一个面向文档 AI 的 Python 工具库,旨在帮助开发者从 PDF、扫描件等非结构化文档中提取结构化信息。它解决了文档解析中常见的布局分析、表格识别、OCR 文本提取、关键信息抽取等难题,提供了一套统一且模块化的 API,可组合多种预训练模型(如 LayoutLM、Detectron2 等)完成端到端的文档理解流水线。其核心能力包括文档版面解析(区域检测、阅读顺序)、表格结构识别、文本与实体抽取,以及可视化调试工具。项目基于 PyTorch 生态,支持自定义模型集成,适合构建文档智能处理系统。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 3269

使用教程

难度:进阶 约 20 分钟 部署方式:本地安装 7 步

环境要求

  • Python 环境,建议使用虚拟环境
  • PyTorch(README 明确说明必须单独安装)
  • 默认方案还需 Tesseract / DocTr 等 OCR 依赖支持
  • 完整方案需先单独安装 Detectron2(不在 PyPI 分发)
  • 如用 Docker 方式,需已安装 Docker 与 Docker Compose

安装与启动步骤

  1. 1创建虚拟环境

    README 推荐在虚拟环境中安装,避免污染全局 Python 环境。创建后需先激活再执行后续安装命令。

  2. 2安装基础依赖

    默认配置解析文档所需的最小依赖:timm、transformers、python-doctr,注意此处使用的是 uv pip 命令。

    uv pip install timm
    uv pip install transformers
    uv pip install python-doctr
  3. 3安装 deepdoctection

    安装核心库本体。以上四步完成后即可运行 README 提到的 Get_Started 入门 notebook。

    uv pip install deepdoctection
  4. 4安装 Detectron2

    若要做完整安装,需先装 Detectron2,它不通过 PyPI 分发,README 给出了从 deepdoctection 分支安装的方式。

    uv pip install --no-build-isolation detectron2@git+https://github.com/deepdoctection/detectron2.git
  5. 5安装完整依赖

    安装 deepdoctection 全部依赖,便于试验各种模型配置。请确认 PyTorch 已单独装好。

    uv pip install deepdoctection[full]
  6. 6源码方式安装

    也可从源码安装:先克隆仓库,README 说明最简单的方式是用 make 安装,且必须有虚拟环境。

    git clone https://github.com/deepdoctection/deepdoctection.git
    make install-dd
  7. 7Docker 方式启动

    从 Docker Hub 拉取官方镜像启动容器,需指定挂载工作目录以便处理文件。容器不对外暴露接口。

    docker compose up -d

如何确认成功

在激活的虚拟环境中执行 python -c "import deepdoctection" 无报错,或直接运行 README 提到的 Get_Started 入门 notebook。

常见问题

Q:为什么装完 deepdoctection 还需要单独装 PyTorch?

A:README 明确说明 PyTorch 始终需要单独安装,deepdoctection 不会代为安装,请按自身 CUDA 环境选择对应版本。

Q:Detectron2 为什么不能直接用 pip install 安装?

A:README 指出 Detectron2 不通过 PyPI 分发,需按官方文档编译安装,或使用 deepdoctection 提供的分支地址安装。

Q:只想快速跑通文档解析,装哪些包就够了?

A:安装 timm、transformers、python-doctr 和 deepdoctection 即可,这一组合足以运行入门 notebook 的默认配置。

Q:Docker 启动后有 API 端口可以调用吗?

A:没有。README 说明容器启动后不暴露任何 endpoint,需要把待处理文件挂载到工作目录后在容器内执行。

Q:v1.0 相比旧版本有什么变化?

A:v1.0 做了较大重构:所有深度学习模型仅支持 PyTorch,支持更多 Huggingface 微调模型,并拆分为 dd-core、dd-datasets 等子包。

注意事项

  • README 中的安装命令使用 uv pip,若用普通 pip 需自行确认对应写法
  • 完整安装前务必先装好 PyTorch 和 Detectron2,否则部分功能不可用
  • Docker 镜像来自 Docker Hub 的 deepdoctection/deepdoctection,运行前需配置好挂载目录
  • v1.0 起模型仅支持 PyTorch,旧版 TensorFlow 相关用法不再适用

核心亮点

  • 模块化设计,可灵活组合不同模型实现定制化文档解析流程
  • 内置多种预训练模型(如 LayoutLM),开箱即用,降低上手门槛
  • 提供可视化工具,便于调试布局检测和 OCR 结果

不足之处

  • 依赖较多,安装配置稍复杂
  • 文档/社区待观察

适用场景

  • 企业合同、发票等票据的自动化信息抽取
  • 学术论文、书籍的版面分析与结构化存储
  • 文档问答系统前期的文档预处理与解析

替代项目

Layout Parser、Tesseract OCR、PaddleOCR

上一篇:Text-Grab

下一篇:frigate

同类项目推荐

manga-image-translator 开源

一键翻译漫画图片文字,自动抹除替换,阅读无国界

Translate manga/image 一键翻译各类图片内文字 https://cotrans.touhou.ai/ (no longer w···

★ 10581 2026-08-10
claude-real-video 开源

让 Claude 看懂视频:自动提取关键帧和字幕,喂给大模型

Let Claude (or any LLM) actually watch a video — scene-aware, deduplicated frames +···

★ 2300 2026-08-09
VisionHOPE 开源

让视觉骨干网络边用边自我修改

Official PyTorch implementation of VisionHOPE: Visual Backbones as Self-Modifying Le···

★ 1416 2026-10-29
scene-language 开源

用程序+文字+嵌入,一句话生成可编辑的3D场景

(CVPR 2025 Highlight) The Scene Language: Representing Scenes with Programs, Words, ···

★ 273 2026-08-09
Unlimited-OCR 开源

一张长图一次推理,整页文字结构直接出

Unlimited OCR Works: Welcome the Era of One-shot Long-horizon Parsing.

★ 30933 2026-10-27
PartGLEE 开源

识别并解析任意物体的部件,让AI看懂物体内部结构

[ECCV2024] PartGLEE: A Foundation Model for Recognizing and Parsing Any Objects

★ 66 2026-08-09
HandX 开源

让数字人双手协作,生成自然交互动作

[CVPR 2026] HandX: Scaling Bimanual Motion and Interaction Generation

★ 150 2026-08-09
particle-life 开源

拖拽调参,让粒子自己长成生命图案

A simple program to simulate artificial life using attraction/reuplsion forces betwe···

★ 3368 2026-08-09
inference 开源

Rust 跑 YOLO,多后端加速,部署轻快

High-performance Ultralytics YOLO inference in Rust with ONNX Runtime, GPU backends,···

★ 217 2026-10-25