Repolode
제출하기
opendatalab

opendatalab/MinerU

PDF, Office 파일, 이미지를 Markdown이나 JSON으로 변환해 LLM 및 에이전트 워크플로에서 활용하는 오픈소스 문서 파서입니다.

대체할 수 있는 제품:Adobe Acrobat

GitHub에서 보기웹사이트
스타
82,105
포크
6,806
열린 이슈
16
마지막 커밋
그저께

어떤 프로젝트인가요?

MinerU는 PDF, 스캔 이미지, Word, PowerPoint, Excel, EPUB, HTML, CSV와 같은 복잡한 문서를 구조화된 콘텐츠로 파싱합니다. 결과물은 Markdown, HTML, LaTeX, DOCX, EPUB, PDF 또는 구조화된 JSON 콘텐츠 목록으로 출력할 수 있어 RAG 파이프라인과 LLM 애플리케이션의 입력으로 적합합니다.

미리보기와 인덱싱에 적합한 빠른 Flash 모드부터 까다로운 레이아웃, 표, 수식을 처리하는 Standard 및 Advanced 모드까지 네 가지 품질 단계를 제공합니다. PDF와 이미지는 모든 단계를 지원하며, Office를 비롯한 기타 형식은 Flash 단계에서 로컬로 파싱합니다. 하드웨어에 따라 ONNX, PyTorch, llama.cpp, vLLM 또는 LMDeploy로 로컬 모델을 실행합니다. 원격 파싱을 명시적으로 설정하지 않는 한 문서는 업로드되지 않습니다.

`mineru` 명령줄 도구, Python SDK, V1 API, Gradio WebUI를 제공하며, 결과를 캐싱하고 검색 및 안정적인 인용 위치 정보가 포함된 페이지 단위 또는 블록 단위 후속 작업을 지원하는 로컬 문서 라이브러리도 제공합니다.

핵심 기능

  • 01PDF, 스캔 이미지, Office 파일, EPUB, HTML, CSV를 Markdown이나 JSON으로 파싱합니다.
  • 02빠른 Flash 파싱부터 복잡한 레이아웃을 위한 Advanced 파싱까지 네 가지 품질 단계를 제공합니다.
  • 03Markdown, HTML, LaTeX, DOCX, EPUB를 포함한 아홉 가지 형식으로 내보냅니다.
  • 04CPU, GPU 또는 Apple Silicon에서 로컬 모델을 실행하며, 설정한 경우에만 원격 파싱을 수행합니다.
  • 05CLI, Python SDK, API, Gradio WebUI와 검색 기능을 갖춘 로컬 문서 라이브러리를 제공합니다.

활용 사례

  • PDF 보고서나 학술 논문을 깔끔한 Markdown으로 변환해 LLM 또는 RAG 파이프라인에 입력합니다.
  • 스캔 문서에서 표와 수식을 추출해 분석합니다.
  • AI 에이전트가 인용 위치 정보를 활용해 긴 문서를 페이지 단위로 읽도록 합니다.
  • Office 및 OpenDocument 파일을 구조화된 텍스트로 일괄 변환합니다.

빠른 시작

  1. 1

    pip으로 uv 설치하기

    pip install uv
  2. 2

    Python 3.12로 가상 환경 만들기

    uv venv .mineru --python 3.12
  3. 3

    환경에 MinerU 4.0 stable 설치하기(README에 따라 먼저 venv를 활성화하세요)

    uv pip install -U "mineru>=4.0,<5"
  4. 4

    PDF를 Markdown으로 변환하기

    mineru-kit parse document.pdf -o document.md --tier standard

사용 전 알아둘 점

  • 라이선스를 자동으로 확인할 수 없었으므로 상업적으로 사용하기 전에 저장소를 확인하세요.
  • 최고의 처리량을 내려면 NVIDIA GPU가 필요합니다. NVIDIA가 아닌 다른 장치에서는 accelerated torch와 vllm 또는 lmdeploy를 수동으로 설치해야 합니다.
  • Windows에서는 torch의 GPU 빌드를 별도로 설치해야 합니다.

토픽

#pdf#document-parsing#ocr#markdown#llm#rag#layout-analysis#python#ai4science#document-analysis

자주 묻는 질문

MinerU은(는) 무엇인가요?
PDF, Office 파일, 이미지를 Markdown이나 JSON으로 변환해 LLM 및 에이전트 워크플로에서 활용하는 오픈소스 문서 파서입니다. MinerU는 PDF, 스캔 이미지, Word, PowerPoint, Excel, EPUB, HTML, CSV와 같은 복잡한 문서를 구조화된 콘텐츠로 파싱합니다. 결과물은 Markdown, HTML, LaTeX, DOCX, EPUB, PDF 또는 구조화된 JSON 콘텐츠 목록으로 출력할 수 있어 RAG 파이프라인과 LLM 애플리케이션의 입력으로 적합합니다.
MinerU은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
MinerU은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
MinerU은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. MinerU의 마지막 커밋은 2026년 10월 19일입니다.
MinerU은(는) 어디에 사용할 수 있나요?
PDF 보고서나 학술 논문을 깔끔한 Markdown으로 변환해 LLM 또는 RAG 파이프라인에 입력합니다. 스캔 문서에서 표와 수식을 추출해 분석합니다. AI 에이전트가 인용 위치 정보를 활용해 긴 문서를 페이지 단위로 읽도록 합니다. Office 및 OpenDocument 파일을 구조화된 텍스트로 일괄 변환합니다.
MinerU는 어떻게 설치하나요?
pip으로 uv 설치하기: pip install uv Python 3.12로 가상 환경 만들기: uv venv .mineru --python 3.12 환경에 MinerU 4.0 stable 설치하기(README에 따라 먼저 venv를 활성화하세요): uv pip install -U "mineru>=4.0,<5" PDF를 Markdown으로 변환하기: mineru-kit parse document.pdf -o document.md --tier standard
MinerU은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/opendatalab/MinerU

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

관련 프로젝트