Repository navigation
Releases
PDF Toolkit v1.0.0
The first stable release of PDF Toolkit, a local-first, self-hosted PDF processing and editing application built with Python, FastAPI, and Uvicorn.
PDF Toolkit provides a browser-based workspace for processing, organizing, and editing PDF documents while allowing users to run and control the application on their own computer or server.
Highlights
- Self-hosted architecture — Run locally with Python, FastAPI, and Uvicorn without requiring a separate web server for basic local operation.
- PDF processing tools — Merge, split, and extract PDF pages.
- Page editor — Preview, reorder, rotate, and delete pages.
- Content editor — Add and edit text, insert and manipulate images, and replace existing content regions.
- Undo/Redo support — Manage editing operations before saving.
- Multilingual interface — Korean, English, Japanese, and Simplified Chinese.
- Three interface themes — Light, Dark, and Warm.
- Responsive interface — Browser-based workspace designed for desktop and smaller screens.
Technology Stack
- Python
- FastAPI
- Uvicorn
- HTML, CSS, and JavaScript
- PDF processing libraries integrated into the application
The same FastAPI application can be used for development and normal local operation, helping maintain consistency between environments.
Installation
Clone the repository:
git clone https://github.com/glitter-node/pdf-toolkit.git
cd pdf-toolkitCreate a Python virtual environment and install dependencies:
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txtStart the application:
.venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8013Open:
Platform-specific dependency compatibility should be verified before deployment.
Documentation
- [README](https://github.com/glitter-node/pdf-toolkit/blob/main/README.md)
- [Windows Auto-Start Guide](https://github.com/glitter-node/pdf-toolkit/blob/main/docs/WINDOWS_AUTOSTART.md)
- [Agent Instructions](https://github.com/glitter-node/pdf-toolkit/blob/main/AGENTS.md)
Security and Privacy
PDF Toolkit is designed for self-hosted operation.
- Process PDF documents using your own application instance.
- Use localhost binding for local-only access.
- Support security headers and Content Security Policy.
- Apply upload validation and processing limits.
- Keep deployment configuration and runtime data under your control.
Self-hosting does not automatically provide authentication or user isolation. Public deployments should use appropriate access controls, HTTPS, request limits, and reverse-proxy security policies.
Release Verification
The v1.0.0 source release completed the following checks:
- Python tests: 156 passed
- JavaScript tests: 35 passed
- Python compilation and JavaScript syntax checks: passed
- Python dependency consistency: passed
- Package integrity checks: passed
- Browser E2E automation: not completed due to a missing Playwright runtime library (
libatomic.so.1)
These results reflect the release preparation checks and do not establish cross-platform compatibility.
Known Limitations
- PDF processing performance and memory usage depend on document complexity and available system resources.
- Browser-based editing behavior may vary by browser and operating system.
- Windows and macOS installation workflows require platform-specific verification.
- Automated browser E2E verification remains incomplete.
Release Information
Version: 1.0.0
Git tag: v1.0.0
Branch: main
Repository: https://github.com/glitter-node/pdf-toolkit
This release establishes the initial stable foundation for future PDF Toolkit development and improvements.