pdf_oxide is a free, open source data extraction & web scraping project written in Rust and released under Apache-2.0. It has 1,033 GitHub stars, 129 forks and 322 open issues, and was last pushed 11 hours ago. On this registry it ranks #42 of 45 tracked projects in Data Extraction & Web Scraping, with 5 head-to-head comparisons available. It gained 1 stars over the last 3 tracked days.

What is pdf_oxide?

PDFOxide is a Rust-core PDF toolkit with bindings for nineteen additional languages, plus a command-line tool and an MCP server, aimed at developers and data teams that need fast, permissively licensed text extraction, image extraction, markdown conversion, and PDF creation and editing.

What it is

PDFOxide is a PDF library built on a Rust core and shipped as idiomatic bindings for nineteen further languages, including Python, Go, JavaScript and TypeScript, C#/.NET, Java, Kotlin, Scala, Clojure, Ruby, PHP, C++, Objective-C, Swift, Dart, R, Julia, Zig, Elixir, and WASM, for a total of twenty supported languages. It also ships a pdf-oxide CLI and a pdf-oxide-mcp server that exposes document handling to AI assistants. The project is dual licensed under MIT and Apache-2.0, hosts its documentation at oxide.fyi, and publishes to crates.io, PyPI, npm, and a Homebrew tap.

The concrete problem it solves is slow and licence-encumbered document parsing. PDFOxide reports a 0.8ms mean per document, which it measures as five times faster than PyMuPDF, fifteen times faster than pypdf, and twenty-nine times faster than pdfplumber, with a 100% pass rate on 3,830 real-world PDFs drawn from veraPDF, Mozilla pdf.js, and DARPA SafeDocs. It replaces both the incumbent Python parsing libraries and, for teams that cannot accept AGPL-3.0 or GPL-3.0 terms, the licence itself: PyMuPDF and pymupdf4llm are AGPL-3.0 and pdftext is GPL-3.0, while PDFOxide is MIT/Apache-2.0.

Key capabilities

  • Text extraction through the lazy page.text property in Python and extract_text(0) in Rust, with per-character data available via the lazy page.chars property.
  • Image extraction through extract_images(0) on a document handle.
  • Markdown conversion with structure detection, via page.markdown(detect_headings=True), doc.to_markdown(0, Default::default()), or the CLI command pdf-oxide markdown document.pdf -o output.md.
  • PDF creation and editing, including merging with pdf-oxide merge a.pdf b.pdf -o combined.pdf.
  • Content search from the shell with pdf-oxide search document.pdf "pattern", and windowed text output with pdf-oxide text document.pdf.
  • An MCP server, pdf-oxide-mcp, configured as an mcpServers entry for Claude Desktop, Claude Code, or Cursor.
  • A WASM build published to npm as pdf-oxide-wasm, alongside the native bindings.

Who uses it and how

  • Data and analytics teams building extraction pipelines over large PDF corpora, where the reported 0.8ms mean and 9ms p99 translate directly into throughput.
  • Retrieval and LLM preprocessing work, served by the pdf-to-markdown and llm topics and the heading-aware markdown conversion path.
  • Polyglot engineering organisations that need one parsing semantics across services written in Python, Go, Java, C#, or TypeScript rather than a different library per runtime.
  • AI assistant integrations that mount the MCP server to give a coding agent direct read access to local PDFs.
  • Shell and batch workflows that call the pdf-oxide CLI instead of embedding a library, including Homebrew installs on developer machines.

Getting started

Install per language: pip install pdf_oxide for Python, pdf_oxide = "0.3" under [dependencies] for Rust, brew install yfedoseev/tap/pdf-oxide for the CLI and MCP server, or pdf-oxide-wasm from npm for the browser build. The Python entry point is from pdf_oxide import PdfDocument used as a context manager.

How it compares

Within its own benchmark table, PDFOxide sits against PyMuPDF, pypdfium2, pymupdf4llm, pdftext, and pdfminer, and the facts position it as the fastest of that set with the only 100% pass rate shown. Its licence is also the most permissive in that group: pypdfium2 is Apache-2.0 and pdfminer is MIT, but PyMuPDF, pymupdf4llm, and pdftext carry AGPL-3.0 or GPL-3.0 obligations. No list of paid products it replaces is provided, so the comparison stops there.

When to use it — and when not to

Nothing needs to be operated: PDFOxide is a library, a CLI, and an MCP server, with no database, object storage, or SMTP dependency mentioned, so the operational cost of adoption is packaging rather than infrastructure. It should not be chosen by teams that need OCR, since the benchmark explicitly covers text-extraction libraries only and excludes OCR. The version is still 0.3.x with 322 open issues, so teams that require a frozen, long-stable API surface or a large third-party answer corpus should weigh that before committing; the breadth of twenty language bindings also implies a wide surface that a single maintainer must keep in step.

project readme (upstream, from github) — read inline

PDFOxide - The Fastest PDF Toolkit for 20 Languages — Python, Rust, Go, JS/TS, C#, Java, Kotlin, Swift, C++ & more, plus CLI & AI

New in v0.3.69 — eleven new language bindings. PDFOxide now ships idiomatic bindings for C++, Swift, Kotlin, Dart, R, Julia, Zig, Scala, Clojure, Objective-C, and Elixir, each built over the stable C ABI with its own CI workflow, api-coverage tests, and runnable examples. That brings the toolkit to 20 languages (Rust core + 19 bindings). Want another language? Open an issue and tell us.

The fastest PDF library for text extraction, image extraction, and markdown conversion. A Rust core with bindings for 19 languages — Python, Go, JavaScript / TypeScript, C# / .NET, Java, Kotlin, Scala, Clojure, Ruby, PHP, C++, Objective-C, Swift, Dart, R, Julia, Zig, Elixir, and WASM — plus a CLI tool and MCP server for AI assistants. 0.8ms mean per document, 5× faster than PyMuPDF, 15× faster than pypdf. 100% pass rate on 3,830 real-world PDFs. MIT licensed.

Crates.io PyPI PyPI Downloads npm Documentation Build Status License: MIT OR Apache-2.0

Quick Start

Python

from pdf_oxide import PdfDocument

with PdfDocument("paper.pdf") as doc:
    print(len(doc))                          # number of pages
    for page in doc:
        text = page.text                     # lazy property
        chars = page.chars                   # lazy property
        md = page.markdown(detect_headings=True)

# Direct page access by index
doc = PdfDocument("paper.pdf")
page = doc[0]
text = page.text
pip install pdf_oxide

Rust

use pdf_oxide::PdfDocument;

let mut doc = PdfDocument::open("paper.pdf")?;
let text = doc.extract_text(0)?;
let images = doc.extract_images(0)?;
let markdown = doc.to_markdown(0, Default::default())?;
[dependencies]
pdf_oxide = "0.3"

CLI

pdf-oxide text document.pdf
pdf-oxide markdown document.pdf -o output.md
pdf-oxide search document.pdf "pattern"
pdf-oxide merge a.pdf b.pdf -o combined.pdf
brew install yfedoseev/tap/pdf-oxide

MCP Server (for AI assistants)

# Install
brew install yfedoseev/tap/pdf-oxide   # includes pdf-oxide-mcp

# Configure in Claude Desktop / Claude Code / Cursor
{
  "mcpServers": {
    "pdf-oxide": { "command": "crgx", "args": ["pdf_oxide_mcp@latest"] }
  }
}

Why PDFOxide?

  • Fast — 0.8ms mean per document, 5× faster than PyMuPDF, 15× faster than pypdf, 29× faster than pdfplumber
  • Reliable — 100% pass rate on 3,830 test PDFs, zero panics, zero timeouts
  • Complete — Text extraction, image extraction, PDF creation, and editing in one library
  • Multi-platform — 20 languages (Rust core + 19 bindings: Python, Go, JS/TS, C#/.NET, Java, Kotlin, Scala, Clojure, Ruby, PHP, C++, Objective-C, Swift, Dart, R, Julia, Zig, Elixir, WASM), plus a CLI and MCP server for AI assistants
  • Permissive license — MIT / Apache-2.0 — use freely in commercial and open-source projects

Performance

Benchmarked on 3,830 PDFs from three independent public test suites (veraPDF, Mozilla pdf.js, DARPA SafeDocs). Text extraction libraries only (no OCR). Single-thread, 60s timeout, no warm-up.

Python Libraries

Library Mean p99 Pass Rate License
PDFOxide 0.8ms 9ms 100% MIT
PyMuPDF 4.6ms 28ms 99.3% AGPL-3.0
pypdfium2 4.1ms 42ms 99.2% Apache-2.0
pymupdf4llm 55.5ms 280ms 99.1% AGPL-3.0
pdftext 7.3ms 82ms 99.0% GPL-3.0
pdfminer 16.8ms 124ms 98.8% MIT
pdfplumber 23.2ms 189ms 98.8% MIT
markitdown 108.8ms 378ms 98.6% MIT
pypdf 12.1ms 97ms 98.4% BSD-3

Rust Libraries

Library Mean p99 Pass Rate Text Extraction
PDFOxide 0.8ms 9ms 100% Built-in
oxidize_pdf 13.5ms 11ms 99.1% Basic
unpdf 2.8ms 10ms 95.1% Basic
pdf_extract 4.08ms 37ms 91.5% Basic
lopdf 0.3ms 2ms 80.2% No built-in extraction

Text Quality

99.5% text parity vs PyMuPDF and pypdfium2 across the full corpus. PDFOxide extracts text from 7–10× more "hard" files than it misses vs any competitor.

Corpus

Suite PDFs Pass Rate
veraPDF (PDF/A compliance) 2,907 100%
Mozilla pdf.js 897 99.2%
SafeDocs (targeted edge cases) 26 100%
Total 3,830 100%

100% pass rate on all valid PDFs — the 7 non-passing files across the corpus are intentionally broken test fixtures (missing PDF header, fuzz-corrupted catalogs, invalid xref streams).

Features

Extract Create Edit
Text & Layout Documents Annotations
Images Tables Form Fields
Forms Graphics Bookmarks
Annotations Templates Links
Bookmarks Images Content

Python API

Page-oriented API

from pdf_oxide import PdfDocument

with PdfDocument("report.pdf") as doc:
    print(len(doc))          # page count
    print(doc.version())

    # Iterate or index pages
    for page in doc:
        text   = page.text                      # str, lazy
        chars  = page.chars                     # list[TextChar], lazy
        words  = page.words                     # list[Word], lazy
        lines  = page.lines                     # list[TextLine], lazy
        tables = page.tables                    # list[Table], lazy
        images = page.images                    # list[Image], lazy
        md     = page.markdown(detect_headings=True)
        html   = page.html()
        print(f"Page {page.index}: {page.width:.0f}×{page.height:.0f} pts")

    # Direct index access (supports negative indices)
    first = doc[0]
    last  = doc[-1]

Scoped extraction

# Extract from a region: (x, y, width, height) in PDF points
header = doc.within(0, (0, 700, 612, 92)).extract_text()
region = doc.within(0, (50, 400, 500, 200))
region_words  = region.extract_words()
region_images = region.extract_images()

Extraction profiles

from pdf_oxide import ExtractionProfile

# Pre-tuned profiles for different document types
words = doc.extract_words(0, profile=ExtractionProfile.form())
lines = doc.extract_text_lines(0, profile=ExtractionProfile.academic())

# Override adaptive thresholds (in PDF points)
words = doc.extract_words(0, word_gap_threshold=2.5)
lines = doc.extract_text_lines(0, word_gap_threshold=2.5, line_gap_threshold=4.0)
params = doc.page_layout_params(0)
print(f"word gap: {params.word_gap_threshold:.1f}")

Form Fields

# Extract form fields
fields = doc.get_form_fields()
for f in fields:
    print(f"{f.name} ({f.field_type}) = {f.value}")

# Fill and save
doc.set_form_field_value("employee_name", "Jane Doe")
doc.set_form_field_value("wages", "85000.00")
doc.save("filled.pdf")

Rust API

use pdf_oxide::PdfDocument;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut doc = PdfDocument::open("paper.pdf")?;

    // Extract text
    let text = doc.extract_text(0)?;

    // Character-level extraction
    let chars = doc.extract_chars(0)?;

    // Extract images
    let images = doc.extract_images(0)?;

    // Vector graphics
    let paths = doc.extract_paths(0)?;

    Ok(())
}

Form Fields (Rust)

use pdf_oxide::editor::{DocumentEditor, EditableDocument, SaveOptions};
use pdf_oxide::editor::form_fields::FormFieldValue;

let mut editor = DocumentEditor::open("w2.pdf")?;
editor.set_form_field_value("employee_name", FormFieldValue::Text("Jane Doe".into()))?;
editor.save_with_options("filled.pdf", SaveOptions::incremental())?;

Installation

Python

pi

readme truncated — read the full docs on github

Frequently asked questions

Is pdf_oxide free to use?

pdf_oxide is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does pdf_oxide do?

The fastest PDF library for Python and Rust. Text extraction, image extraction, markdown conversion, PDF creation & editing. 0.8ms mean, 5× faster than industry

What is pdf_oxide written in?

pdf_oxide is primarily written in Rust. Its source is publicly available at https://github.com/yfedoseev/pdf_oxide, and it has 1,033 GitHub stars.