Glitter Gim

설치형 P/G의 정해진 기능에 의존하지 않고 유연한 로컬 자체 호스팅(Self-hosting)으로 PDF Toolkit을 ~

· 2026-11-19 (목) 19:54:16 · 33

PDF Toolkit은 Python + FastAPI + Uvicorn 기반의 로컬 자체 호스팅(Self-hosting) PDF 처리·편집 도구입니다.

Linux·Windows·macOS에서 Docker, Nginx, Apache 또는 별도 데이터베이스 서버 없이
Python 가상환경과 필요한 PDF 처리 라이브러리만으로 실행할 수 있도록 구성했습니다.

PDF 파일을 외부 서비스에 전송하지 않고 자신의 PC에서 직접 처리하여 데이터 관리와 프라이버시를 중시합니다.

FastAPI + Uvicorn 기반으로 개발·실행 환경을 일원화하여,
사용자가 소스 코드를 직접 수정하고 기능을 확장하며 변경 사항을 즉시 반영해 사용할 수 있습니다. (--reload 사용 시)

설치형 프로그램의 정해진 기능에 의존하기보다, 사용자가 직접 수정·확장하고 바로 적용하는 유연한 로컬 자체 호스팅을 지향합니다.

필요에 따라 Nginx·Apache 등 기존 웹 서버와 연동할 수도 있지만, 외부 서비스 운영이 아닌 로컬 자체 호스팅이 기본 목적입니다.


※ 주요 기능

  • PDF 병합: 2~10개 PDF 파일을 지정한 순서대로 하나로 병합

  • 페이지 추출·분할: 필요한 페이지나 범위를 추출하고, 페이지별·범위별 분할 및 ZIP 다운로드

  • 페이지 변환·최적화: 페이지 회전, PNG/JPEG 이미지 변환, PDF 파일 크기 최적화

  • 워터마크·보안: 문자·Unicode·이미지 워터마크 삽입, PDF 열기 암호 설정

  • 텍스트 추출: PDF의 선택 가능한 텍스트를 TXT 파일로 추출

  • 페이지 편집기: 썸네일 미리보기, 드래그 순서 변경, 페이지 이동·회전·삭제 및 저장

  • 콘텐츠 편집기: 텍스트·이미지 추가 및 수정, 글꼴·색상·정렬 설정, 객체 이동·크기 조절, 지정 영역 제거·대체, Undo/Redo

  • 파일 처리: 업로드 검증, 파일 크기·페이지 수·동시 처리 제한, 결과 파일 다운로드

  • 사용자 인터페이스: 한국어·영어·일본어·중국어 지원, Light·Dark·Warm 테마

※ OCR 및 기존 PDF의 모든 텍스트·이미지를 자유롭게 수정하는 범용 편집 기능은 제공하지 않습니다.
 

※ 기술 스택

Python, FastAPI, Uvicorn, Jinja2, Pydantic, pypdf, PyMuPDF, ReportLab, Pillow, cryptography, HTML5, CSS3, Vanilla JavaScript, REST API
 

※ 설치 및 운영 환경

  • Linux: Python 가상환경 및 PDF 처리 라이브러리 기반 실행

  • Windows: Python 가상환경 및 작업 스케줄러를 이용한 자동 시작 설정 안내

  • macOS: Intel 및 Apple Silicon 환경을 위한 설치 방법 제공

  • 공통: Python 및 프로젝트 의존성 설치, Docker 및 별도의 웹·데이터베이스 서버 설치 불필요

개발과 운영에 동일한 FastAPI 애플리케이션과 Uvicorn 실행 구조를 사용합니다.

Windows·macOS의 전체 설치 및 PDF 편집 기능은 추가 검증이 필요합니다.


※ 프로젝트 링크

라이선스: MIT License


PDF Toolkit v1.0.0은 첫 공개 버전으로,
복잡한 서버 구성 없이 자신의 PC에서 PDF 처리·편집 도구를 직접 실행하고 관리할 것을 지향합니다.

로컬 자체 호스팅과 Python 기반 애플리케이션 개발에 관심 있는 분들께 도움이 되기를 바라며, 오류 및 개선 의견 환영합니다.
 

○ 참고 : 해당 포트폴리오

댓글을 작성하시려면 로그인이 필요합니다.

자유게시판

203,405건
+
제목 글쓴이 날짜 조회
11-18 조회 138
19:54 조회 34
19:19 조회 33
16:26 조회 39
16:04 조회 77
15:47 조회 74
14:25 조회 45
14:09 조회 85
13:17 조회 59
13:08 조회 39
11:08 조회 95
09:53 조회 49
02:43 조회 117
00:22 조회 90
11-18 조회 128
11-18 조회 119
11-18 조회 74
11-18 조회 129
11-18 조회 88
11-18 조회 118
11-18 조회 127