Repolode
pymupdf

pymupdf/PyMuPDF

MuPDF 엔진 기반의 고성능 Python 라이브러리로, PDF와 기타 문서 형식을 추출·분석·변환·렌더링·편집할 수 있습니다.

대체할 수 있는 제품:Adobe Acrobat

스타
10,938
포크
813
열린 이슈
58
마지막 커밋
6시간 전

어떤 프로젝트인가요?

PyMuPDF는 PDF 및 기타 문서 형식을 처리하는 경량 C 엔진인 MuPDF의 Python 바인딩입니다. Python 코드로 글꼴, 크기, 색상, 위치 정보와 함께 텍스트를 읽고, 표를 감지해 내보내며, 페이지를 이미지로 렌더링하고, 삽입된 이미지를 추출할 수 있습니다.

추출 외에도 주석 추가, 민감 정보 가림, 양식 작성, 페이지 편집, 파일 병합 및 분할, 책갈피와 메타데이터 관리가 가능하며 PDF를 생성하거나 Markdown을 PDF로 변환할 수도 있습니다. 또한 문서를 Markdown, JSON, 일반 텍스트로 내보낼 수 있어 LLM 및 RAG 파이프라인에 적합합니다. OCR은 RapidOCR 또는 Tesseract를 통해 사용할 수 있으며, 선택 사항인 PyMuPDF Office 확장 기능을 추가하면 Word, Excel, PowerPoint 및 HWP 파일을 지원합니다.

Python 3.11 이상용 휠이 Windows, macOS, Linux에서 제공됩니다. 프로젝트는 AGPL-3.0 라이선스로 배포되며, 독점 소프트웨어에 사용할 수 있는 상용 라이선스는 Artifex에서 제공합니다.

핵심 기능

  • 01글꼴, 크기, 색상, 경계 상자 메타데이터와 함께 텍스트를 추출합니다
  • 02표를 감지해 Markdown 또는 pandas DataFrame으로 내보냅니다
  • 03원하는 DPI로 페이지를 PNG 또는 JPEG로 렌더링합니다
  • 04주석을 추가하고 가림 처리를 영구 적용합니다
  • 05AcroForm 필드를 읽고 작성합니다
  • 06LLM 사용을 위해 문서를 Markdown, JSON, 일반 텍스트로 내보냅니다
  • 07RapidOCR 또는 Tesseract로 OCR을 수행합니다

활용 사례

  • PDF 콘텐츠를 구조화된 Markdown으로 변환해 LLM 또는 RAG 파이프라인에 입력
  • 금융 또는 정부 보고서에서 표를 추출해 DataFrame으로 가져오기
  • 문서를 공유하기 전에 민감 정보를 가리기
  • 스크립트로 PDF를 일괄 병합, 분할하거나 워터마크 추가하기

빠른 시작

  1. 1

    PyPI에서 PyMuPDF 설치

    pip install --upgrade pymupdf
  2. 2

    PDF에서 텍스트 추출

    python -c "import pymupdf; doc = pymupdf.open('document.pdf'); [print(p.get_text()) for p in doc]"

사용 전 알아둘 점

  • Office 문서를 지원하려면 라이선스 키가 필요하며, 키가 없으면 처음 3페이지만 이용할 수 있습니다.
  • 핵심 라이브러리는 AGPL-3.0 라이선스가 적용되며, 네트워크를 통해 사용하거나 배포할 경우 카피레프트 의무가 따릅니다.

토픽

자주 묻는 질문

PyMuPDF은(는) 무엇인가요?
MuPDF 엔진 기반의 고성능 Python 라이브러리로, PDF와 기타 문서 형식을 추출·분석·변환·렌더링·편집할 수 있습니다. PyMuPDF는 PDF 및 기타 문서 형식을 처리하는 경량 C 엔진인 MuPDF의 Python 바인딩입니다. Python 코드로 글꼴, 크기, 색상, 위치 정보와 함께 텍스트를 읽고, 표를 감지해 내보내며, 페이지를 이미지로 렌더링하고, 삽입된 이미지를 추출할 수 있습니다.
PyMuPDF은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
PyMuPDF은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
PyMuPDF은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. PyMuPDF의 마지막 커밋은 2026년 10월 20일입니다.
PyMuPDF은(는) 어디에 사용할 수 있나요?
PDF 콘텐츠를 구조화된 Markdown으로 변환해 LLM 또는 RAG 파이프라인에 입력 금융 또는 정부 보고서에서 표를 추출해 DataFrame으로 가져오기 문서를 공유하기 전에 민감 정보를 가리기 스크립트로 PDF를 일괄 병합, 분할하거나 워터마크 추가하기
PyMuPDF는 어떻게 설치하나요?
PyPI에서 PyMuPDF 설치: pip install --upgrade pymupdf PDF에서 텍스트 추출: python -c "import pymupdf; doc = pymupdf.open('document.pdf'); [print(p.get_text()) for p in doc]"
PyMuPDF은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pymupdf/PyMuPDF

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트