Skip to content

PDF Toolkit v1.0.0

Latest

Choose a tag to compare

@glitter-gim glitter-gim released this 19 Nov 12:37

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-toolkit

Create a Python virtual environment and install dependencies:

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt

Start the application:

.venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8013

Open:

http://127.0.0.1:8013/

Platform-specific dependency compatibility should be verified before deployment.

Documentation

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.