What is SoPDF
SoPDF is an open-source Python PDF processing library that covers the full workflow from rendering and text extraction to structural editing. You can use it to build production-grade parsing, retrieval, split/merge, and batch processing pipelines. See the API Docs for functions, objects, and examples.SoPDF is released under Apache 2.0. You can use it in personal projects, commercial products, and open-source libraries.
Quick start
In an empty directory, install SoPDF with Python 3.10 or later and download a one-page test PDF. W3C test PDFquickstart.py and run python quickstart.py. The first page is doc[0] because page indexes start at 0.
page-1.png, saves the text to page-1.txt, and prints Dummy PDF file.
Why SoPDF
- High performance: official benchmarks show major speedups vs PyMuPDF in core scenarios (up to about
2.82xin rendering,2.74xin plain text extraction, and3.17xin full-text search). - Feature complete: supports rendering, extraction, search, split/merge, compressed save, metadata, and outline handling.
- Clean API: designed for practical day-to-day engineering workflows.
- Permissive license: Apache 2.0 simplifies internal adoption and external distribution.
Core capabilities
Architecture
SoPDF uses a dual-engine architecture:pypdfium2(Google PDFium): rendering, text extraction, and search.pikepdf(libqpdf): structure reads, writes, and save/compression.
Resources
- Repository: SoMarkAI/SoPDF
- PyPI: sopdf
- Examples:
examples/in the repository - Benchmark suite:
tests/benchmark/in the repository

