MinerU의 개요
MinerU는 PDF, 스캔본과 이미지, Word, PowerPoint, Excel, EPUB, OFD, HTML, CSV 파일을 Markdown, HTML, LaTeX, DOCX 또는 구조화된 JSON으로 변환하며, 표, 수식, 읽기 순서를 유지합니다. OmniDocBench 벤치마크도 관리하는 OpenDataLab이 만들며, 비전 모델 MinerU2.5-Pro가 이를 통해 배포됩니다.
2026년 9월 16일에 나온 버전 4.0은 네 단계로 재편됐습니다. Flash는 PDF 자체의 텍스트 레이어를 읽고, Basic은 CPU에서 도는 작은 OCR, 수식, 표 모델을 더하며, Standard와 Advanced는 llama.cpp, vLLM, LMDeploy로 서빙하는 12억 파라미터 비전 모델을 더합니다. 에이전트가 페이지와 블록 단위로 검색하고 인용할 수 있는 로컬 문서 라이브러리도 추가했습니다. 버전 4.1은 Intel, AMD, NVIDIA, Apple 하드웨어의 GPU 자동 감지와 새 비동기 Tasks API를 가져왔습니다.
라이선스는 2026년 4월에 바뀌었습니다. 버전 3.1.0은 AGPLv3를 MinerU Open Source License로 대체했습니다. Apache 2.0에 조건을 더한 것으로, 월간 활성 사용자 1억 명 또는 월 매출 $2,000만을 넘으면 상용 라이선스가 필요하고, 이를 기반으로 만든 서비스는 MinerU를 쓴다고 밝혀야 합니다.
MinerU, 쓸 만한 가치가 있습니까?
MinerU의 모델은 이 분야 최상위권에 가깝고, 근거도 자체 보고에만 기대지 않습니다. OpenDataLab은 MinerU2.5-Pro가 OmniDocBench v1.6에서 95.69를 기록했다고 보고하는데, 같은 1.2B 아키텍처에서 데이터 작업만으로 2.71점을 올린 결과입니다. 단서는 OpenDataLab이 OmniDocBench를 관리하고 v1.6을 같은 논문에서 정의했다는 점입니다. 경쟁사인 TII의 Falcon OCR 모델 카드에 실 린 표는 더 수수하지만 여전히 강합니다. OmniDocBench 93.22로 PaddleOCR-VL-1.6의 94.95에 뒤지고, olmOCR-bench 81.5로 그 표에서 dots.mocr, Chandra OCR 2, Falcon OCR 자신에게만 뒤집니다.
라이선스는 꼼꼼히 읽어야 합니다. 2026년 4월 AGPLv3에서 벗어나면서 카피레프트 의무는 사라졌고, 월 사용자 1억 명 또는 월 매출 $2,000만이라는 기준은 대부분의 회사와 무관합니다. 그러나 MinerU로 만든 온라인 서비스는 이를 눈에 띄게 밝혀야 하며, 그렇게 하지 않으면 라이선스가 자동으로 종료됩니다. OSI 승인 라이선스가 아니므로 일부 법무팀은 검토 대상으로 취급할 것입니다. 이력도 신중함을 더합니다. 저장소는 2026년 3월 AGPL에서 Apache로, 다시 AGPL로 바꿨다가 4월에야 정착했습니다.
단계는 실제 절충입니다. Flash와 Basic은 일반 CPU에서 돌고, CPU만 있는 기기에서는 논리 코어가 12개 이상일 때만 Standard 단계가 자동으로 켜집니다. 비전 모델 단계에는 GPU가 필요하며, 8 GB VRAM은 보장이 아니라 계획의 출발점으로 설명됩니다. 모델 카드는 vLLM을 쓰는 A100 한 대에서 초당 2.12페이지를 보고합니다. Marker 관리자들은 MinerU의 이전 파이프라인을 olmOCR-bench 72.7, B200에서 초당 0.54페이지로 측정했으므로, 결과는 어떤 단계와 버전을 돌리느냐에 크게 좌우됩니다.
프로젝트는 빠르게 움직입니다. 9월 16일의 4.0.0부터 11월 2일의 4.1.4까지 릴리스가 18번 있었고, 4.1은 HTTP API를 깨뜨려 서버, 라우터, SDK, 클라이언트를 함께 업그레이드해야 했습니다. 스타 82,996개에 열린 이슈가 11개뿐이니 유지보수는 분명히 활발합니다. 대가는 버전을 고정하고 마이그레이션 가이드를 읽는 일이 운영의 일부라는 점입니다.
제 역할을 하는 곳
중국어와 영어 연구 논문 500,000편의 검색을 만드는 ML 엔지니어
수식과 표가 있는 PDF를 깔끔한 Markdown으로 바꾸기
GPU 호스트 한 대에서 vLLM과 함께 Standard 단계로 mineru-kit parse를 돌립니다. 모델 카드의 A100 기준 초당 2.12페이지라면 500만 페이지(논문당 10페이지)는 한 장의 카드로 약 27일이 걸리므로, 다중 서비스 Router로 여러 GPU에 나누십시오.
코딩 에이전트에 사내 문서 접근 권한을 주는 플랫폼팀
에이전트가 긴 문서를 페이지 단위로 읽고 정확한 위치를 인용하게 하기
mineru 스킬을 설치하고 로컬 문서 라이브러리를 시작합니다. 에이전트는 한 번 파싱한 뒤 파일 전체를 불러오는 대신 문서, 페이지, 블록 위치로 읽습니다. 원격 파싱을 설정하지 않으면 문서는 업로드되지 않습니다.
제품에 파서를 넣는 SaaS 회사의 리걸 오퍼레이션 책임자
MinerU를 고객에게 내보내기 전에 라이선스 확인하기
사용자 1억 명과 월 매출 $2,000만 기준 아래에서는 상용 라이선스가 필요 없습니다. 하지만 제품 인터페이스나 공개 문서에 MinerU를 쓴다고 밝혀야 하며, 그렇지 않으면 라이선스 가 종료됩니다.
도입 전 확인할 점
- 설정
- Python 3.11에서 3.14: uv pip install -U "mineru>=4.0,<5" 후 mineru-kit parse document.pdf -o document.md --tier standard를 실행합니다. 고처리량 NVIDIA 서빙에는 mineru[full]을 쓰며, 모델은 Hugging Face나 ModelScope에서 내려받습니다.
- 연동
- CLI, Python SDK(DoclibClient), V1 HTTP와 Tasks API, 다중 서비스 Router, Gradio 웹 UI, 에이전트 스킬, 원격 VLM 엔드포인트 옵션. Markdown, HTML, LaTeX, DOCX, JSON 콘텐츠 목록을 포함한 아홉 가지 출력 형식.
- 데이터와 개인정보
- 로컬에서 실행됩니다. 문서에 따르면 원격 파싱을 명시적으로 설정하지 않는 한 문서는 공식 서비스에 업로드되지 않습니다. MinerU2.5-Pro 가중치는 Apache 2.0이고, 툴킷은 MinerU Open Source License를 따릅니다.
- 대규모 사용 시 비용
- 자체 호스팅 비용은 하드웨어입니다. Flash와 Basic은 CPU에서 돌고, 문서는 고처리량 사용에 최소 16 GB 시스템 메모리를 권하며, MinerU2.5-Pro는 vLLM을 쓰는 A100 한 대에서 초당 2.12페이지에 도달했습니다.
- 제한
- 자동 단계 선택은 GPU 메모리를 확인하지 않음. NVIDIA 외 장치용 Docker는 업데이트 대기 중. Office와 웹 형식은 Flash만 사용. 4.1에서 HTTP API가 호환되지 않게 바뀜.
좋은 점
- 경쟁사(TII) 비교에서 MinerU2.5-Pro가 OmniDocBench 93.22
- CPU 텍스트 레이어 파싱부터 GPU 비전 모델 파싱까지 네 단계
- Office, EPUB, OFD, HTML, CSV를 네이티브로 파싱
- 매우 활발함: 2026년 9월 중순부터 11월 초까지 릴리스 18번
아쉬운 점
- 출처 표시 의무와 매출 기준이 있는 자체 라이선스
- 대표 벤치마크인 OmniDocBench를 OpenDataLab이 직접 운영
- 4.1에서 HTTP API 호환성 깨짐
- 2026년 3월과 4월 라이선스 파일이 AGPL과 Apache 사이에서 세 번 바뀜
추천 대상
PDF와 Office 파일이 뒤섞인 대량 컬렉션을 자체 하드웨어에서 파싱하며 출처 표시 조항을 받아들일 수 있는 RAG 팀과 데이터 팀.
MinerU 대안
MinerU: 자주 묻는 질문
- MinerU, 쓸 만한 가치가 있습니까?
- MinerU는 가장 정확한 오픈 문서 모델 가운데 하나를 활발하고 문서화가 잘된 툴킷과 묶었습니다. 다만 라이선스는 더 이상 순수한 오픈소스가 아니 고 API는 계속 바뀝니다. 평점은 5점 만점에 4.3점입니다.
- MinerU의 가격은 얼마입니까?
- MinerU Open Source License(조건이 추가된 Apache 2.0)로 무료입니다. 월간 활성 사용자 1억 명(100,000,000명) 또는 월 매출 $2,000만을 넘으면 별도의 상용 라이선스가 필요합니다.
- MinerU의 단점은 무엇입니까?
- 출처 표시 의무와 매출 기준이 있는 자체 라이선스; 대표 벤치마크인 OmniDocBench를 OpenDataLab이 직접 운영; 4.1에서 HTTP API 호환성 깨짐; 2026년 3월과 4월 라이선스 파일이 AGPL과 Apache 사이에서 세 번 바뀜.
- MinerU에 적합한 사람은 누구입니까?
- PDF와 Office 파일이 뒤섞인 대량 컬렉션을 자체 하드웨어에서 파싱하며 출처 표시 조항을 받아들일 수 있는 RAG 팀과 데이터 팀.
- 팀이나 프로덕션 환경에서 MinerU의 비용은 얼마입니까?
- 자체 호스팅 비용은 하드웨어입니다. Flash와 Basic은 CPU에서 돌고, 문서는 고처리량 사용에 최소 16 GB 시스템 메모리를 권하며, MinerU2.5-Pro는 vLLM을 쓰는 A100 한 대에서 초당 2.12페이지에 도달했습니다.
- MinerU에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 실행됩니다. 문서에 따르면 원격 파싱을 명시적으로 설정하지 않는 한 문서는 공식 서비스에 업로드되지 않습니다. MinerU2.5-Pro 가중치는 Apache 2.0이고, 툴킷은 MinerU Open Source License를 따릅니다.
- MinerU의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Docling, Marker 및 Unstructured입니다.
답변 확인일: 2026년 11월 2일.
MinerU 개발사입니까? 이 평점을 사이트에 표시하십시오
