When it comes to PDF manipulation in Python, most developers reach for proprietary libraries or bindings to external tools. pypdf (formerly known as pypdf2) takes a different approach — it's a pure-Python library with zero third-party C dependencies, meaning you can install it with a simple pip install pypdf and start splitting, merging, cropping, and transforming PDFs immediately on any platform.

Originally maintained by the community and later adopted by the pypdf organization, the library has grown into a mature, actively developed project with nearly 10,000 GitHub stars and over 1,300 open issues — a healthy sign of an active community. Version 3.x brought a major API redesign, and the project continues to iterate rapidly, with recent pushes adding better form handling, image extraction, and type annotation coverage.

What sets pypdf apart is its breadth: it handles everything from basic page extraction and rotation to advanced features like PDF form filling, metadata editing, content stream analysis, and AES encryption. Whether you're building a document processing pipeline, automating report generation, or building a PDF reader, pypdf is a go-to tool that stays Python-native.

• Zero-dependency pure Python — no C extensions, no external binaries. Just Python. Works anywhere Python runs, including constrained environments.
• Full PDF content model support — read and write page-level actions, annotations, form fields (AcroForms), metadata, encryption, and more through a well-documented Pythonic API.
• Active maintenance & modern tooling — comprehensive type hints, pytest-based test suite, PEP 8 compliance enforcement via mypy, and a growing set of examples in the documentation.

---

pypdf's GitHub Issues are a rich source of real-world PDF edge cases and feature discussions. Here are a few that stood out:

The reporter describes a common problem when processing PDFs generated by tools like LibreOffice: every page references all images in the entire document, so naive image extraction returns duplicate images regardless of which page you're on. The maintainer acknowledged this as a known limitation in the PDF spec's image referencing model and discussed potential fixes. This is a great example of how pypdf's community surfaces real-world PDF quirks that pure Adobe SDK users take for granted.

PDF pages can contain an "Additional Actions" (AA) dictionary that triggers JavaScript or other actions on events like page open/close. The community proposed a clean action() class that wraps the PDF action type system, making it extensible for different action subtypes. This discussion showcases pypdf's commitment to API ergonomics — the maintainers actively review proposals before merging, ensuring the interface is intuitive and consistent.

A user filed that radio button fields set via update_page_form_field_values appear selected in Apple Preview but not in Adobe Acrobat or Chrome's built-in PDF viewer. This is a classic PDF compatibility issue — different viewers have different requirements for how widget annotations and field values interact. The pypdf team engaged to understand the PDF spec nuances around radio button state encoding.

---

pypdf is a standout in the Python PDF space precisely because it achieves depth without compromising accessibility. Its pure-Python nature, active community-driven development, and willingness to tackle complex PDF spec edge cases make it an essential tool for any Python developer working with documents. Whether you need to merge a batch of reports, extract text from specific pages, or build a full PDF processing pipeline, pypdf has you covered — and the GitHub Issues show a community that genuinely cares about correctness and usability.

⭐ Stars: 9,979  |  Issues: 1,398+  |  Language: Python
📦 pip install pypdf