Repolode
SoMarkAI

SoMarkAI/OXR

PDF와 문서 이미지를 레이아웃 좌표가 포함된 Markdown 또는 JSON으로 변환하는 오픈소스 문서 파싱 모델로, AI 에이전트 파이프라인을 지원합니다.

스타
3,643
포크
239
열린 이슈
3
마지막 커밋
17시간 전

어떤 프로젝트인가요?

OXR(Optical Everything Recognition)은 SoMark 팀이 개발한 13억 파라미터 문서 파싱 모델입니다. PDF와 문서 이미지를 입력받아 레이아웃 경계 상자가 포함된 Markdown 또는 JSON을 출력하므로, 결과를 후속 AI 에이전트 및 검색 파이프라인에 전달할 수 있습니다.

이 모델은 LaTeX 수식, HTML 또는 Markdown 표, 화학 방정식과 구조식, 코드 블록, 도장 등을 포함한 13가지 요소 유형을 인식합니다. 읽기 순서는 인식 단계에서 동일한 모델이 처리합니다. 레이아웃 분석은 교체 가능한 별도 모듈이므로, OXR의 인식 및 순서 처리 기능은 유지하면서 자체 레이아웃 모델을 사용할 수 있습니다.

프로젝트는 Docker 이미지, vLLM을 지원하는 소스 빌드 설치 방식, 포트 8000에서 실행되는 브라우저 데모, SoMark API 및 Python·JavaScript CLI와 호환되는 무료 호스팅 API를 제공합니다. 로컬 배포에는 BF16을 지원하는 NVIDIA GPU가 필요하며, 메모리는 최소 24GB부터 권장합니다.

핵심 기능

  • 01PDF와 이미지를 레이아웃 경계 상자가 포함된 Markdown 또는 JSON으로 파싱합니다.
  • 02수식, 표, 화학 구조식, 코드 블록 등을 포함한 13가지 요소 유형을 인식합니다.
  • 03인식과 읽기 순서 처리를 동일한 모델에서 수행합니다.
  • 04레이아웃 분석은 별도 모듈로 제공되며 사용자 지정 모델로 교체할 수 있습니다.
  • 05Docker 배포, vLLM 기반 소스 설치 방식, 브라우저 데모를 제공합니다.
  • 06SoMark CLI 및 SDK와 호환되는 API를 제공합니다.

활용 사례

  • 스캔한 시험지, 논문 또는 보고서를 LLM이나 RAG 파이프라인용 구조화 텍스트로 변환합니다.
  • 학술 문서에서 복잡한 표와 수식을 추출합니다.
  • OXR의 인식 기능을 재사용하면서 특정 문서 분야에 맞게 레이아웃 분석을 조정합니다.

빠른 시작

  1. 1

    PyPI에서 somark CLI를 설치합니다

    pip install somark
  2. 2

    무료 OXR API로 문서를 파싱합니다(API 키 불필요)

    somark --base-url https://free-oxr.somark.ai/api/v1 --api-key dummy parse document.pdf --formats md,json --out ./parsed-output/

사용 전 알아둘 점

  • 로컬에서 실행하려면 GPU 메모리가 24GB 이상인 NVIDIA GPU 탑재 Linux 머신이 필요합니다.
  • 무료 API는 안정성을 보장하지 않으며 프로덕션 환경에서의 사용을 권장하지 않습니다.
  • README에 소프트웨어 라이선스가 명확하게 명시되어 있지 않으므로, 상업적으로 사용하기 전에 저장소를 확인하세요.

포함된 컬렉션

토픽

자주 묻는 질문

OXR은(는) 무엇인가요?
PDF와 문서 이미지를 레이아웃 좌표가 포함된 Markdown 또는 JSON으로 변환하는 오픈소스 문서 파싱 모델로, AI 에이전트 파이프라인을 지원합니다. OXR(Optical Everything Recognition)은 SoMark 팀이 개발한 13억 파라미터 문서 파싱 모델입니다. PDF와 문서 이미지를 입력받아 레이아웃 경계 상자가 포함된 Markdown 또는 JSON을 출력하므로, 결과를 후속 AI 에이전트 및 검색 파이프라인에 전달할 수 있습니다.
OXR은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
OXR은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
OXR은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. OXR의 마지막 커밋은 2026년 11월 6일입니다.
OXR은(는) 어디에 사용할 수 있나요?
스캔한 시험지, 논문 또는 보고서를 LLM이나 RAG 파이프라인용 구조화 텍스트로 변환합니다. 학술 문서에서 복잡한 표와 수식을 추출합니다. OXR의 인식 기능을 재사용하면서 특정 문서 분야에 맞게 레이아웃 분석을 조정합니다.
OXR는 어떻게 설치하나요?
PyPI에서 somark CLI를 설치합니다: pip install somark 무료 OXR API로 문서를 파싱합니다(API 키 불필요): somark --base-url https://free-oxr.somark.ai/api/v1 --api-key dummy parse document.pdf --formats md,json --out ./parsed-output/
OXR은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/SoMarkAI/OXR

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

관련 프로젝트