설치형 P/G의 정해진 기능에 의존하지 않고 유연한 로컬 자체 호스팅(Self-hosting)으로 PDF Toolkit을 ~
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 기반 애플리케이션 개발에 관심 있는 분들께 도움이 되기를 바라며, 오류 및 개선 의견 환영합니다.
○ 참고 : 해당 포트폴리오
최신댓글
댓글을 불러오는 중입니다.
최신글
글을 불러오는 중입니다.