TypeScriptOtherCreated Jan 27, 2023Last push todayLatest release v3.3.0+516 stars this week+2.4K this month
Quick answers
What is Stirling-PDF?
A comprehensive, self-hosted open-source platform offering deep PDF manipulation and conversion tools without externa...
What does Stirling-PDF do?
Stirling PDF is a highly capable open-source document manipulation platform that empowers users to perform comprehensive edits, conversions, and automation on PDF files locally. It operates primarily as a Dockerized web application, ensuring sensitive documents are fully processed locally without ever pinging external cloud services for heightened data security. The platform consolidates a massive array of utilities, allowing users to effortlessly merge, split, OCR, digitally sign, and deeply redact dense multi-page documents directly from their browser. By exposing a completely private internal API, developers can also seamlessly integrate complex PDF processing routines into their own self-hosted automation pipelines.
Who is Stirling-PDF for?
Privacy-conscious individuals, enterprises, and developers who need a powerful, fully locally-hosted solution for managing and editing PDF files securely. It is suitable for professionals looking for efficiency.
How do I get started with Stirling-PDF?
docker run -p 8080:8080 stirlingtools/stirling-pdf
How popular is Stirling-PDF on GitHub?
Stirling-Tools/Stirling-PDF has 97,112 stars and 9,383 forks on GitHub, and gained 516 stars in the last 7 days.
What license does Stirling-PDF use?
Stirling-Tools/Stirling-PDF is released under the Other license.
Star history
since Jul 28, 2026
97.1K stars as of Nov 21, 2026. Measured daily since Jul 28, 2026; GitHub no longer exposes earlier star timestamps.
Update history
4 recorded
Nov 5, 2026New release v3.3.0 (previously v3.2.2).
Oct 25, 2026New release v3.2.2 (previously v3.1.0).
Oct 14, 2026New release v3.1.0 (previously v3.0.2).
Oct 5, 2026Primary language changed from Java to TypeScript.
Contribution activity
commits per day, last 52 weeks
2,108 commits in the last yearLessMore
Signals and awards
derived from tracked data
Landmark project
97,112 stars
Very active
2,108 commits in 52 weeks
Community-driven
~323 contributors
Well documented
High community health score
Continuous integration
Automated checks passing
Top 10% tracked
Rank 93 of 1243
What Stirling-PDF does
Stirling PDF is a highly capable open-source document manipulation platform that empowers users to perform comprehensive edits, conversions, and automation on PDF files locally. It operates primarily as a Dockerized web application, ensuring sensitive documents are fully processed locally without ever pinging external cloud services for heightened data security. The platform consolidates a massive array of utilities, allowing users to effortlessly merge, split, OCR, digitally sign, and deeply redact dense multi-page documents directly from their browser. By exposing a completely private internal API, developers can also seamlessly integrate complex PDF processing routines into their own self-hosted automation pipelines.
Privacy-conscious individuals, enterprises, and developers who need a powerful, fully locally-hosted solution for managing and editing PDF files securely. It is suitable for professionals looking for efficiency.
Total Privacy: Ensures all document processing, OCR, and redaction happens completely locally on your hardware without external API calls.
Comprehensive Editing Toolset: Enables deep structural changes to files including merging, splitting, signing, and granular page reordering.
Advanced OCR Integration: Converts scanned images into fully searchable and selectable text documents seamlessly using localized processing.
Private Developer API: Exposes a comprehensive local web API allowing complex PDF transformation routines to be automated securely.
Multi-Environment Deployment: Supports running natively as a desktop application, directly in the browser, or as a self-hosted Docker container.
Extensive Format Conversion: Converts documents fluidly back and forth between PDF and numerous image, word, or structured text formats.
Where teams use it
Secure Document Redaction
Legal professionals utilize the platform to completely locally redact sensitive personal information from case files without trusting cloud converters.
Automated OCR Pipelines
Developers deploy the Docker container to automatically ingest and parse incoming physical scans using the exposed local API.
Enterprise Document Standardization
Host the application internally to provide all staff with a robust, highly secure unified PDF editor.
Rapid Batch Processing
Archivists utilize the comprehensive merging and splitting tools to organize and rapidly catalog massive historical document libraries offline.
Getting started: docker run -p 8080:8080 stirlingtools/stirling-pdf
README
main branch
Stirling PDF - The Open-Source PDF Platform
Stirling PDF is a powerful, open-source PDF editing platform. Run it as a personal desktop app, in the browser, or deploy it on your own servers with a private API. Edit, sign, redact, convert, and automate PDFs without sending documents to external services.
Key Capabilities
Everywhere you work - Desktop client, browser UI, and self-hosted server with a private API.
50+ PDF tools - Edit, merge, split, sign, redact, convert, OCR, compress, and more.
Automation & workflows - No-code pipelines direct in UI with APIs to process millions of PDFs.
Enterprise‑grade - SSO, auditing, and flexible on‑prem deployments.
Developer platform - REST APIs available for nearly all tools to integrate into your existing systems.
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
This project uses Task as a unified command runner for all build, dev, and test commands. Run task dev to get started running the editor, run task to see the most common commands, or see the Developer Guide for full details.
Stirling Office Convert (still beta) has been upgraded. You can also now pick it as the converter in lots of other tools such as Email, HTML, Markdown and ebooks to PDF plus PDF to HTML/Markdown/XML/EPUB/AZW3, and PDF/A. Please compare it with the existing converter and let us know!
Our roadmap is to turn Office Convert on by default next week, and then, if no changes are required, fully remove LibreOffice and other dependencies the week after. So now is the best time to try it and report (And send example files) any conversions that don't look correct!
Other changes are:
- SSO auto-login now works even when username/password login is enabled (admins can still reach the password form via /login?all)
- JPDFium upgrade and support and Windows ARM64 support, This update also brings better redaction, merge/split improvements and lower memory on big files
- Faster and more accurate mobile scanning, with no more 9MB OpenCV bundled
- Faster requests with far fewer database reads and new entity caching
- Quieter startup and runtime logs
- Spring Boot, Docker base image and lots of other dependency updates
- Updated translations for all languages
We also fixed some bugs inc
Another small release with some bug fixes
- Fix for some viewer rendering issues
- New auto fit to width button for viewer
- New annotation shape options like arrow and polyline
- QR code stamp types
## What's Changed
### Bug Fixes
* fix(i18n): expand Turkish translations by @alkank in https://github.com/Stirling-Tools/Stirling-PDF/pull/8123
* fix(viewer): render non-embedded fonts with matching widths by @reecebrowne in https://github.com/Stirling-Tools/Stirling-PDF/pull/8629
### Enhancements
* feat(viewer): Fit to width and fit to page buttons in the viewer by @EthanHealy01 in https://github.com/Stirling-Tools/Stirling-PDF/pull/8485
* Fix race condition in storybook by @jbrunton96 in https://github.com/Stirling-Tools/Stirling-PDF/pull/8619
* build(deps-dev): bump fast-uri from 3.1.7 to 3.1.9 in /frontend by @dependabot[bot] in https://github.com/Stirling-Tools/Stirling-PDF/pull/8580
* build(deps-dev): bump ip-address from 10.7.2 to 10.7.4 in /frontend by @dependabot[bot] in https://github.com/Stirling-Tools/Stirling-PDF/pull/8630
* build(deps): bump dompurify from 3.4.16 to 3.4.17 in /frontend by @dependabot[bot] in https://github.com/Stirling-Tools/Stirling-PD
Smaller release with some nice viewer and editor improvements and bug fixes for annotation and compression
Key features are:
- Arrow key support for viewer
- Dual page view to support cover pages
- Read aloud now starts at the selected text
- You can now duplicate pages in page editor (multi tool)
- Memory optimisations
- Label damaged PDFs and offer Repair
- Export PDF comments as CSV
Bug fixes
- Fixed cases were compression was not correctly compressing
- Fixed various annotation issues introduced in 3.2.0
- Fixed issues with default tool picker mode
<!-- Release notes generated using configuration in .github/release.yml at main -->
## What's Changed
### Bug Fixes
* fix: persist Default tool picker mode and Default view on launch settings by @mvanhorn in https://github.com/Stirling-Tools/Stirling-PDF/pull/6827
* fix(annotate): transparent shape fills and hollow default shapes by @reecebrowne in https://github.com/Stirling-Tools/Stirling-PDF/pull/8574
* fix(viewer): exit annotation mode when the toolbar button is clicked again by @balazs-szucs in https://github.com/Stirling-Tools/Stirling-PDF/pull/8590
### Enhancements
* Update Backend 3rd Party Lic
Another good release!
The old multi-tool has been replaced by a completely redesigned Page Editor. It now resupports images, renaming files, and a bunch of QOL UI changes making it much easier to rearrange and manage your documents. Please let us know what you think and if you have any issues with it!
Some big changes in how we handle password-protected PDF, They can now be opened for viewing and used with common tools without having to remove the password first, and your existing PDF permission settings are kept when unlocking.
Other changes are:
- Stirling Sign now emails participants and requesters as a signing request progresses
- Drop files anywhere on the workbench, plus a redesigned add-files button
- Compression now tells you when it could not shrink a file
- Tidied booklet imposition UI with guide diagrams
- Optional redirectBaseUrl for OAuth2 and SAML when running behind reverse proxies
- Faster startup and lower memory use in the viewer and text editor
- Refreshed icons and chat UI improvements
We also fixed some bugs including
- Desktop crashing when reordering files on Mac
- Form drafts being lost before saves completed
- Signatures being lost when
Some big changes in this release yet again!
Group signing (Called Stirling Sign) is moving out of alpha and is now being enabled by default for new users, with it, you can share, track, and sign PDFs across your org. It also comes with a brand new sign UI, drastically improving the user experience of signing. Please let us know if you have any issues with it!
We are also shipping a new embedded conversion tool called "Stirling Office Convert" which we are trialing, It aims to give better conversion results faster and with less memory. This is a beta, so please compare and let us know! (Enable it by default under Advanced > Feature Flags)
We have a ton of other features in this release:
- Text editor supports editing tables directly in file!
- Text editor supports editing OCRed image PDFs!
- Text editor UI and UX improvements
- Attachments Support improvements (Add, rename, extract, delete etc)
- Several Dependency updates
And to mention again:
- Brand new Group signing UI
- New PDF conversion tool, hopefully to replace the old tool in the future (and coming to native desktop soon!)
- Sign tool improvements
We also fixed some bugs including
- Certain tran
Code frequency
additions and deletions
+4.9M lines added, -3.8M removed over the last year.
Commits per week
last 52 weeks
2.1K commits in the last 52 weeks.
When work happens
weekday and hour
Commit volume by weekday and hour (UTC). Larger dots mean more commits.