MinerU 빠른 시작 — 설치와 CLI 사용

MinerU 빠른 시작

MinerU는 pip/uv로 설치하고, 능력이 되는 환경이면 단순 CLI 한 줄로 문서를 파싱해요. 복잡한 레이아웃에선 온라인 데모로 결과를 먼저 확인해 보는 것도 권장돼요.

출처: https://github.com/opendatalab/MinerU/blob/master/docs/en/quick_start/index.md

설치

pip install --upgrade pip
pip install uv
uv pip install -U "mineru[all]"

소스로 설치할 땐 git clone https://github.com/opendatalab/MinerU.gituv pip install -e .[all]을 쓰면 돼요.

사용

GPU 가속 조건을 만족하면:

mineru -p <input_path> -o <output_path>

GPU 없이 순수 CPU 환경이면 pipeline 백엔드를 지정해요:

mineru -p <input_path> -o <output_path> -b pipeline

로컬 PDF·이미지·DOCX·PPTX·XLSX 파일 또는 디렉터리를 입력으로 받아요.

참고

설치·하드웨어 지원표는 공식 퀵 스타트 문서에 자세히 나와 있어요. 예를 들어 ray 의존성 때문에 Windows Python은 3.10~3.12만 지원되는 등의 제약이 있으니 미리 확인하는 게 좋아요.

더 알아보기