Nginx·Apache 등 별도의 웹 서버 설치 없이, Python + FastAPI + Uvicorn만으로 로컬 PC에서 Image Toolkit을 즐기자!
외부 웹 이미지 변환 서비스에 의존하지 않고,
자신의 PC(Linux·Windows·macOS)에 직접 설치하고 운영할 수 있는 로컬 자체 호스팅(Self-hosting) 이미지 처리 도구를 목표로 합니다.
이미지를 외부 서비스에 전송하지 않고 자신의 환경에서 직접 처리할 수 있도록 하여 데이터 관리와 프라이버시를 중시하는 사용 환경을 목표로 했습니다.
특히 개발 환경과 운영 환경의 일관성을 고려하여 Python + FastAPI + Uvicorn 조합을 채택했습니다.
Docker, Nginx, Apache 또는 별도의 데이터베이스 서버 없이 Python 가상환경과 SQLite만으로 실행할 수 있습니다.
물론, 필요에 따라 Nginx·Apache 등의 기존 웹 서버와 연동하여 외부에 서비스를 제공하는 것도 가능합니다.
별도의 웹 서버가 필요 없다는 것은 사용이 제한된다는 의미가 아니라,
웹 서버 설치 없이도 독립적으로 실행할 수 있다는 의미입니다.
※ 주요 기능
-
이미지 형식 변환: JPEG, PNG, WebP, AVIF, HEIC 등 지원(설치된 코덱에 따라 상이)
-
이미지 편집: 크기 조정, 자르기, 회전, 반전, 밝기·대비·채도·선명도 조절
-
워터마크: 텍스트 및 PNG 로고 삽입
-
일괄 처리: 최대 10개 이미지 처리, 진행 상태 확인, 작업 취소 및 ZIP 다운로드
-
작업 관리: SQLite 기반 작업 이력 관리 및 임시 파일 자동 정리
-
사용자 인터페이스: 브라우저 미리보기, 한국어·영어·일본어·중국어 지원, 라이트·다크 테마
※ 기술 스택
Python, FastAPI, Uvicorn, Pillow, SQLite, Pydantic, HTML5, CSS3, Vanilla JavaScript
※ 설치 및 운영 환경
-
Linux: Python 가상환경 기반 실행
-
Windows: Python 가상환경 및 작업 스케줄러를 이용한 자동 시작 지원
-
macOS: Intel 및 Apple Silicon 환경을 위한 설치 방법 제공
-
공통: Docker 및 별도의 웹·데이터베이스 서버 설치 불필요
개발과 운영에 동일한 FastAPI 애플리케이션과 Uvicorn 실행 구조를 사용합니다.
운영체제별 설치 및 일부 이미지 코덱 호환성은 추가 검증이 필요합니다.
※ AI 에이전트를 활용한 설치
Python이나 서버 실행 환경에 익숙하지 않은 사용자도
AI 에이전트의 도움을 받아 PDF Toolkit을 설치하고 실행할 수 있도록 운영체제에 종속되지 않는 공통 설치 요청 프롬프트를 제공합니다.
GitHub에 제공된 설치 프롬프트를 사용 중인 AI 에이전트에 전달하면,
로컬 운영체제와 시스템 환경을 먼저 확인하고 프로젝트 문서를 참고하여 가상환경 구성, 의존성 설치, 애플리케이션 실행 및 오류 해결을 안내받을 수 있습니다.
또한 Linux·Windows·macOS 등 확인된 운영체제에 적합한 자동 시작 설정도 설치 과정에 포함되어 있습니다.
AI 에이전트의 실행 권한과 환경에 따라 설치 및 설정을 직접 수행하거나 단계별 안내를 받아 진행할 수 있습니다.
※ 프로젝트 링크
라이선스: MIT License
Image Toolkit v0.1.0은 첫 공개 버전입니다.
복잡한 서버 환경을 구성하지 않고도 자신의 PC에서 이미지 변환과 편집 기능을 직접 운영할 수 있도록 하는 것이 이 프로젝트의 핵심 목표입니다.
아직 부족한 부분이 있을 수 있지만, 로컬 자체 호스팅과 Python 기반 애플리케이션 개발에 관심 있는 분들께 참고가 되었으면 합니다.
사용 중 발견한 오류나 개선 의견은 GitHub Issues를 통해 자유롭게 남겨주시면 감사하겠습니다.
○ 참고 : 해당 포트폴리오
댓글 11개
요즘 파이선이랑 놀이 중입니다. ㅋ~
물론입니다.
인트라넷의 호스트나 로컬 호스트가 이미 웹 서버로 운영 중이라면 그렇게 사용하셔도 됩니다.
다만, 별도의 Nginx·Apache 없이 일반 PC에서도
'Python + FastAPI + Uvicorn'만으로 독립적으로 실행하고 운영할 수 있다는 것이 프라이버시를 중시하는 이 프로젝트의 핵심 취지입니다. (●'◡'●)
빤한 사실인데 관점을 달리하니 프라이버시 관리가 되고 좋겠네요.
맞습니다.
새로운 스킬이라기보다는 기존 기술을 어떻게 활용하느냐일 뿐입니다.
별도의 웹 서버를 설치하지 않고,
외부 서비스에 이미지를 맡기지도 않으면서 자신의 PC에서 직접 처리하고 관리할 수 있다는 점에 의미를 두었습니다. (●'◡'●)
말씀하신 것처럼 외부에 공개하기 곤란한 자료를 다룰 때 유용할 것 같습니다.
프라이버시를 중시하는 로컬 자체 호스팅 환경에 'Python + FastAPI + Uvicorn' 조합이 잘 어울린다 싶어 이것저것 만들어 보고 있습니다.
아직 첫 버전이라 부족한 부분이 있겠지만, 사용해 보시고 개선할 점이 있다면 의견 부탁드립니다.
감사합니다. (●'◡'●)
다음은 뭘까요.
시리즈 ㅋ~ 'Python + FastAPI + Uvicorn' 조합으로 이것저것 만들어 보는 중입니다.
오디오 쪽을 만지고 있습니다.
하나씩 만들어 보는 재미가 있네요. (●'◡'●)
공개합니다.