OpenDataLoader PDF란?
OpenDataLoader PDF는 PDF를 AI에 쓸 수 있는 데이터로 변환합니다. 청킹용 Markdown, 출처 표시용 경계 상자 포함 JSON, HTML, 또는 주석이 달린 PDF입니다. 제목, 표, 목록, 읽기 순서를 인식하며, JSON에는 제목 수준, 글꼴, 각 요소의 위치가 유지됩니다. Python, Node.js, Java SDK와 명령줄 도구를 갖춘 라이브러리로 제공됩니다.
개발 주체는 GitHub 조직 opendataloader-project이며, 사이트 하단에는 "© 2026 OpenDataLoader"라고 적혀 있습니다. 홈페이지는 접근성 관련 작업이 Hancom, 그리고 홈페이지가 veraPDF 개발자 중 하나로 설명하는 Dual Lab과 함께 개발되었다고 하지만, 파서를 Hancom이 만든다고는 하지 않습니다. 어느 법인이 프로젝트를 유지 관리하는지는 출처에 나와 있지 않습니다. 별도의 엔터프라이즈 제품 Hancom Data Loader는 "Coming Soon"으로 표시되어 있으며 오픈소스 핵심에는 포함되지 않습니다.
설치 방법
OpenDataLoader PDF는 Java 런타임을 준비한 뒤 패키지 관리자로 설치합니다. 데스크톱 설치 프로그램도, 스토어 등록도 없습니다.
옵션 | 입수 방법 |
|---|---|
| Python(pip) | Java 11+를 준비한 뒤 pip install -U opendataloader-pdf(PyPI); CLI도 함께 추가됩니다 |
| Node.js | npm의 @opendataloader/pdf, Node.js 퀵스타트 기준 |
| Java(Maven) | org.opendataloader:opendataloader-pdf-core, Java 퀵스타트 기준 |
| 하이브리드 모드 | `pip install "opendataloader-pdf[hybrid]"`; README에 따르면 처음 모델을 내려받는 데 몇 분이 걸릴 수 있습니다 |
| CLI 아카이브 | GitHub Releases의 opendataloader-pdf-cli-2.5.22.zip |
| 웹사이트 | opendataloader.org |
| 개인정보 처리방침 | 사이트 하단에 링크된 개인정보 처리방침; 표시하려면 JavaScript가 필요합니다 |
| 소스 코드 | github.com/opendataloader-project/opendataloader-pdf, Apache 2.0 |
확인한 버전: 2.5.22(2026년 11월 12일 출시), 마지막 업스트림 업데이트는 2026년 11월 14일. 터미널과 개발 환경이 필요합니다. Java 11 이상이 PATH에 있어야 하고(java -version으로 확인) pip 방식에는 Python 3.11 이상이 필요합니다. 퀵스타트 페이지는 Python 3.10이라고 적었지만 README와 PyPI는 3.11이라고 하므로 PyPI를 따르십시오. 프로젝트는 운영체제 목록을 공개하지 않으며, PyPI는 이 패키지를 운영체제에 독립적인 것으로 표시합니다.
로컬 및 하이브리드 데이터 흐름
기본 모드에서 파서는 사용자의 기기에서 실행됩니다. README는 "100% locally", "No API calls, no data transmission"이라고 밝히고, 홈페이지는 "No API keys, no cloud"라고 밝힙니다. GPU는 필요하지 않으며 RAM 사양은 공개되어 있지 않습니다.
하이브리드 모드는 어려운 페이지를 AI 백엔드로 보내 OCR, 수식과 차트 처리, 표 정확도를 높입니다. 이 백엔드는 기본적으로 127.0.0.1의 로컬 서버이고 이미지 설명에는 로컬 SmolVLM-256M 모델이 쓰이지만, --hybrid-url 옵션은 어떤 주소든 받습니다. 원격 서버를 지정하면 페이지가 그곳으로 전송되며, "클라우드 없음"이라는 설명은 더 이상 사용자의 구성에 해당하지 않습니다.
📌참고: 이는 개발 측의 설명이며 감사 결과가 아닙니다. PromptQuorum은 네트워크 트래픽이나 코드를 검사하지 않았습니다.
출처가 확인한 기능
아래 항목은 모두 웹사이트, README 또는 PyPI에 나온 내용이며, 여기서는 하나도 테스트하지 않았습니다.
- 레이아웃 분석. XY-Cut++ 알고리즘으로 읽기 순서를 복원하며, 표는 병합된 셀을 포함해 추출됩니다.
- 출처 표시. JSON의 모든 요소에 경계 상자가 있어, 답변이 페이지의 특정 위치를 가리킬 수 있습니다.
- OCR. 하이브리드 모드에서만 사용할 수 있으며, 기본 엔진은 EasyOCR이고 대안으로 RapidOCR, Tesseract, Apple Vision(macOS 전용), NVIDIA Nemotron(CUDA가 있는 Linux x86_64), 자동 선택이 있습니다. 프로젝트는 80개 이상의 언어를 지원한다고 하지만 엔진별 내역은 없습니다.
- AI 안전 필터링. 숨겨진 텍스트, 페이지 밖 콘텐츠, 프롬프트 인젝션 패턴을 텍스트가 모델에 도달하기 전에 걸러낼 수 있습니다.
- LangChain.
langchain-opendataloader-pdf패키지가OpenDataLoaderPDFLoader를 제공하며, RAG 통합 가이드도 공개되어 있습니다. - 접근성 자동 태깅. 태그가 없는 PDF에 Well-Tagged PDF 사양에 따라 태그를 달고 veraPDF로 검증할 수 있으며, PDF/UA 내보내기는 엔터프라이즈 등급에 속합니다.
벤치마크: 개발 측의 주장
홈페이지와 README의 "#1 in benchmarks" 주장은 프로젝트 자체의 opendataloader-bench에서 나온 것이며, 하이브리드 모드에만 적용됩니다. 방법은 벤치마크 페이지에 설명되어 있으며, PromptQuorum은 어떤 수치도 재현하지 않았습니다.
- 전체 점수: 하이브리드 모드 0.907, 하이브리드 없이 0.831.
- 표 정확도(TEDS): 하이브리드 모드 0.928, 하이브리드 없이 0.489.
- 제목 감지: Docling 0.824, 하이브리드 0.821, 비하이브리드 0.739로, 모든 범주에서 이 주장이 성립하는 것은 아닙니다.
- 페이지당 속도: Nutrient 0.008초, OpenDataLoader 로컬 0.015초, 하이브리드 0.463초이며, README FAQ에는 "60+ pages per second"라고도 적혀 있습니다.
라이선스와 가격
저장소의 LICENSE 파일에 따르면 코드는 Apache 2.0 라이선스이며, 2.0 이전 릴리스는 MPL 2.0이었습니다. Core, Audit, Auto-tag는 무료로 사용할 수 있습니다.
엔터프라이즈 등급은 PDF/UA 내보내기와 시각적 편집 스튜디오를 추가합니다. 가격은 공개되어 있지 않으며 문의 페이지를 통해 요청합니다.
이런 분께 적합합니다
- RAG를 구축하는 분 중 이미 가지고 있는 PDF에서 위치 정보가 있는 구조화된 Markdown 또는 JSON이 필요한 분.
- Java 런타임을 쓸 수 있는 팀 중 Python 패키지 전에 JDK를 설치하는 것을 받아들일 수 있는 팀.
- 접근성 담당 팀 중 기존 PDF에 자동으로 태그를 달고 veraPDF로 확인하려는 팀.
확인하지 못한 내용
- 정확도와 속도. 모든 수치는 프로젝트 자체의 것이며, PromptQuorum이 측정한 것은 없습니다.
- 텔레메트리. 관련 설명을 찾지 못했으므로 어느 쪽도 가정하지 않습니다.
- Docker. 홈페이지에는 컨테이너 방식이 나오지만 README에는 없고 이미지도 찾지 못했습니다.
- 운영체제. 지원 목록이 공개되어 있지 않으며, 확인한 CI 워크플로는 Linux에서 실행됩니다.
- 다른 파일 형식. Word, Excel, PowerPoint, 이미지 입력은 핵심에서 처리되지 않으며, Hancom Data Loader는 발표만 되었을 뿐 출시되지 않았습니다.
- 유지 관리 주체. 프로젝트 뒤의 법인은 밝혀져 있지 않습니다.
경쟁 앱과 대안
Xberg
- 플랫폼:
- Mac, Windows, Linux
- 가격 / 라이선스:
- 무료 / MIT
- 핵심 차이:
- Office 파일, 오디오, URL도 읽는 Rust 엔진. OpenDataLoader PDF는 PDF만 읽음
CocoIndex
- 플랫폼:
- Mac, Windows, Linux
- 가격 / 라이선스:
- 무료 / Apache 2.0
- 핵심 차이:
- 인덱스를 최신으로 유지하는 파이프라인 프레임워크. 이 도구 같은 파서가 필요하며 대체하지 않음
CocoIndex 관련 문서 (1개)
- CocoIndex Review: Incremental Data Framework for RAG and AI Agents업데이트 2026년 11월 8일
Docling과 Nutrient는 프로젝트 자체의 벤치마크 표에 나오며, 이 리뷰가 의존하는 비교는 그것뿐입니다. 선택하기 전에 각 도구의 최신 가격, 라이선스, 지원 플랫폼을 해당 페이지에서 확인하세요.
자주 묻는 질문
Python을 작성하지 않고도 쓸 수 있습니까?
예. pip 패키지가 명령줄 도구를 설치하고 Node.js와 Java SDK도 있지만, 어느 방식이든 기기에 Java 11 이상이 필요합니다.
파일을 반복문으로 처리하면 호출마다 느린 이유는 무엇입니까?
README에 따르면 convert()를 호출할 때마다 JVM 프로세스가 시작되므로, 여러 파일이나 폴더를 한 번의 호출로 전달하기를 권장합니다.
스캔한 PDF에서도 작동합니까?
OCR을 실행하는 하이브리드 모드를 통해서만 가능하며, 기본 모드는 지원하지 않습니다.
Hancom Data Loader는 같은 제품입니까?
아니요. DOCX, XLSX, PPTX, HWP, 이미지를 읽을 예정인 별도의 엔터프라이즈 제품이며, README는 2026년 2분기 또는 3분기를 목표로 제시했으나 확인 시점에는 아직 출시되지 않았습니다.
LangChain 파이프라인에는 어떻게 추가합니까?
README에 설명된 대로 langchain-opendataloader-pdf를 설치하고 OpenDataLoaderPDFLoader를 사용합니다.
총평
OpenDataLoader PDF는 활발하게 릴리스되는 Apache 2.0 방식으로, PDF에서 위치 정보가 있는 구조화된 Markdown과 JSON을 얻을 수 있고 기본 모드는 완전히 로컬이라고 문서화되어 있습니다. 반면 pip 전에 Java가 필요하고, PDF만 읽으며, 1위라는 순위는 프로젝트가 직접 만든 벤치마크에서 하이브리드 모드에 한해서만 나왔고, 텔레메트리와 유지 관리 주체는 밝혀져 있지 않으며, PromptQuorum이 테스트하지도 않았습니다. PDF를 RAG에 투입하고 터미널 설정을 받아들일 수 있는 개발자에게 적합하며, PDF 이외의 파일이 필요하다면 Xberg를 비교해 보십시오.
출처
- OpenDataLoader 웹사이트 — 제품 개요, 벤치마크, 엔터프라이즈 등급(2026년 11월 15일 확인).
- GitHub의 OpenDataLoader PDF — README, 라이선스, 릴리스 2.5.22, 저장소 활동(2026년 11월 15일 확인).
- PyPI의 opendataloader-pdf — 패키지 버전 2.5.22와 Python 요구 사항(2026년 11월 15일 확인).
- Python 퀵스타트 — 설치 절차와 해당 페이지가 명시한 Python 버전(2026년 11월 15일 확인).
- 벤치마크 방법론 — 프로젝트 자체 점수를 산출하는 방법(2026년 11월 15일 확인).
