git404hub

what is pdf-craft fr?

oomol-lab/pdf-craft — explained in plain English

Analysis updated 2026-06-26

5,630PythonAudience · researcherComplexity · 3/5Setup · hard

tl;dr

pdf-craft converts scanned PDF books into Markdown or EPUB locally on your machine, using AI to read text from page images and handle tables, formulas, and footnotes.

vibe map

mindmap
  root((pdf-craft))
    What it does
      Scanned PDF to Markdown
      Scanned PDF to EPUB
      Local processing
    Features
      OCR via DeepSeek
      Tables and formulas
      Auto table of contents
      Footnote handling
    Requirements
      NVIDIA GPU with CUDA
      Poppler
      Python pip
    Use cases
      Book digitization
      Research document prep
      Offline conversion

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Convert a scanned PDF book into a clean Markdown file with tables and formulas preserved.

VIBE 2

Turn a scanned PDF into an EPUB with an automatically generated table of contents for e-reader use.

VIBE 3

Process old scanned documents offline without sending any files to an external server.

what's the stack?

PythonCUDADeepSeek OCRPoppler

how it stacks up fr

oomol-lab/pdf-craftidealo/imagededupfacebookresearch/mmf
Stars5,6305,6305,629
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity3/52/54/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires an NVIDIA GPU with CUDA configured and Poppler installed, no CPU fallback.

License information is not clearly stated in the explanation.

in plain english

pdf-craft is a Python library for converting PDF files into Markdown or EPUB format. It is built specifically for scanned books, where pages are images rather than searchable text. The library uses a document recognition model called DeepSeek OCR to read text from those scanned pages, handling complex content such as tables, mathematical formulas, and footnotes. The conversion runs entirely on your own machine without sending files to any outside server. To use it, you need a compatible NVIDIA graphics card with CUDA configured, plus Poppler, a tool for parsing PDF files. The library itself is installed via pip, the standard Python package installer. During conversion, pdf-craft analyzes the document's layout: it pulls out the main body text while discarding headers, footers, and other repeated page elements. For EPUB output specifically, it builds a table of contents automatically. Footnotes, embedded images, and other assets attached to footnotes are carried through to the final file intact. Starting with version 1.0.0, the library dropped the large language model it previously used for text correction. The older approach made network calls and introduced delays or occasional failures. The current version relies entirely on the local OCR model, so the process runs faster and works without an internet connection. Users who depended on the LLM correction step can still use the older v0.2.8 release. An online demo lets anyone try the conversion workflow in a browser without installing anything locally. The Python API exposes functions for Markdown and EPUB conversion, each accepting optional parameters for DPI settings, image size limits, language, table rendering format, and formula display style.

prompts (copy fr)

prompt 1
Using pdf-craft, write Python code to convert a scanned PDF book into EPUB format with an auto-generated table of contents.
prompt 2
I want to convert a scanned academic paper with mathematical formulas into Markdown using pdf-craft. What parameters should I set for formula display and table format?
prompt 3
My scanned PDF has headers and footers on every page that I want stripped out. How does pdf-craft handle those during conversion?
prompt 4
Walk me through setting up pdf-craft from scratch on Linux with CUDA and Poppler, then converting my first PDF.
prompt 5
What are the differences between pdf-craft v0.2.8 with LLM correction and v1.0.0 with local OCR only, when would I prefer the older version?

Frequently asked questions

what is pdf-craft fr?

pdf-craft converts scanned PDF books into Markdown or EPUB locally on your machine, using AI to read text from page images and handle tables, formulas, and footnotes.

What language is pdf-craft written in?

Mainly Python. The stack also includes Python, CUDA, DeepSeek OCR.

What license does pdf-craft use?

License information is not clearly stated in the explanation.

How hard is pdf-craft to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is pdf-craft for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.